@farmslot/recipe-runner 0.23.0

package/dist/core/types.d.ts

@@ -0,0 +1,319 @@
+import type { RecipeActionManifestDocument, RecipeArtifactManifestEntry, RecipeExecutionApproval, RecipeExecutionCapability, RecipeExecutionPlan, RecipeFailureCause, RecipeResolutionDocument, RecipeSourceProvenance, UiObserverRef } from '@farmslot/protocol';
+export type RecipeRunStatus = 'pass' | 'fail' | 'unknown';
+export type RecipeVideoRecordingMode = 'off' | 'full-run';
+export interface RecipeRunRequest {
+    recipePath?: string;
+    recipeDocument?: unknown;
+    artifactsDir: string;
+    projectRoot?: string;
+    env?: Record<string, string | undefined>;
+    /** Disable ambient process inheritance when the caller supplies the complete execution environment. */
+    inheritProcessEnv?: boolean;
+    recordVideo?: boolean | RecipeVideoRecordingMode | RecipeVideoRecordingOptions;
+    /** Provenance assigned by the caller; omitted sources receive unknown trust. */
+    source?: RecipeSourceProvenance;
+    /** Out-of-band approval bound to the fully resolved execution-plan digest. */
+    approval?: RecipeExecutionApproval;
+    /** Root recipe parameters. Defaults from paramsSchema are applied first. */
+    params?: Record<string, unknown>;
+    /** Active adapter used for recipe selection and manifest capability validation. */
+    adapter?: string;
+    /** Ordered recipe library sources; the first source declaring a recipe ref wins. */
+    librarySources?: RecipeLibrarySource[];
+    /** Package versions the host provides for checking each library's `requires`. */
+    packageVersions?: Readonly<Record<string, string>>;
+    /** How the caller chose a library recipe by name; recorded in the summary. */
+    selection?: RecipeSelection;
+    /**
+     * Partial execution: stop the root graph after this node succeeds, then run the recipe's
+     * declared teardown. The node must be reachable from workflow.entry.
+     */
+    stopAfterNode?: string;
+}
+export interface RecipeLibrarySource {
+    /** Source name used in resolution output. Defaults to the directory basename. */
+    name?: string;
+    /** Library root directory containing recipes/ and optionally runner-owned manifests/actions. */
+    root: string;
+    /** Trust comes from caller configuration, never from library contents. */
+    provenance?: RecipeSourceProvenance;
+    /** Where the entry was configured: --library flag, RECIPE_LIBRARY_PATH, the personal default, or task-local. */
+    origin?: RecipeLibraryOrigin;
+    /** Root of the RECIPE_LIBRARY_PATH entry with the same name that a --library flag replaced. */
+    overrides?: string;
+}
+export type RecipeLibraryOrigin = 'flag' | 'env' | 'default' | 'task';
+/** A library recipe chosen by name: ref, qualified platform alias, or `<library>.<ref>` id. */
+export interface RecipeSelection {
+    /** The name as given. */
+    name: string;
+    resolvedBy: 'ref' | 'alias' | 'id';
+    /** Library that provided the recipe. */
+    source: string;
+    /** Recipe file relative to that library root. */
+    file: string;
+    path: string;
+}
+export interface LoadedRecipeLibrarySource {
+    name: string;
+    root: string;
+    recipeCount: number;
+    provenance: RecipeSourceProvenance;
+}
+export interface RecipeShadowEntry {
+    ref: string;
+    /** Winning source. */
+    source: string;
+    /** Catalog file path relative to the winning source's root. */
+    file: string;
+    /** Source names shadowed at lower precedence. */
+    shadows: string[];
+}
+export interface RecipeLibrarySummary {
+    sources: LoadedRecipeLibrarySource[];
+    /** Every cross-source shadowing in the resolution, used or not. */
+    shadowed: RecipeShadowEntry[];
+}
+export interface RecipeRunResult {
+    status: RecipeRunStatus;
+    summaryPath: string;
+    tracePath: string;
+    artifactManifestPath: string;
+    recipePath: string;
+}
+export interface RecipeRunner {
+    /** Resolve and authorize the exact execution plan without running actions or writing artifacts. */
+    preflight(request: RecipeRunRequest): Promise<RecipeExecutionPlan>;
+    run(request: RecipeRunRequest): Promise<RecipeRunResult>;
+}
+export interface RecipeLogger {
+    info(message: string): void;
+    warn(message: string): void;
+    error(message: string): void;
+}
+export interface RecipeRunnerProvenance {
+    source: string;
+    git_ref: string;
+    name?: string;
+    version?: string;
+}
+export interface CreateRecipeRunnerOptions {
+    actionManifest: RecipeActionManifestDocument;
+    adapters: ActionAdapter[];
+    /** Caller-owned default provenance. Omit to fail closed with unknown trust. */
+    defaultSource?: RecipeSourceProvenance;
+    logger?: RecipeLogger;
+    hud?: RecipeHudOptions | false;
+    runner?: RecipeRunnerProvenance;
+    recording?: RecipeRecordingOptions;
+    /** Capabilities denied when recipe or implementation provenance is not trusted. */
+    blockedCapabilities?: RecipeExecutionCapability[];
+}
+export interface RecipeVideoRecordingOptions {
+    mode?: RecipeVideoRecordingMode;
+    maxFps?: number;
+    maxSize?: number;
+    target?: RecordingTarget;
+}
+export interface RecipeRecordingOptions {
+    targetProvider?: RecordingTargetProvider;
+    videoRecorder?: VideoRecorder;
+}
+export interface RecordingTargetProvider {
+    resolveRecordingTarget(context: RecordingTargetContext): Promise<RecordingTarget>;
+}
+export interface RecordingTargetContext {
+    nodeId: string;
+    node: Record<string, unknown>;
+    recipe: unknown;
+    projectRoot: string;
+    artifactsDir: string;
+    env: Record<string, string | undefined>;
+    scope?: 'run' | 'node';
+}
+export type RecordingTarget = {
+    kind: 'android-device';
+    serial: string;
+} | {
+    kind: 'window-id';
+    windowId: string;
+} | {
+    kind: 'pid';
+    pid: number;
+} | {
+    kind: 'app-window';
+    appName: string;
+    windowName: string;
+} | {
+    kind: 'simulator';
+    device: string;
+};
+export interface VideoRecorderStartRequest {
+    outputPath: string;
+    target: RecordingTarget;
+    maxFps?: number;
+    maxSize?: number;
+    nodeId: string;
+    record: 'full_run';
+}
+export interface ActiveVideoRecording {
+    stop(): Promise<VideoRecordingResult>;
+    /** Capture a PNG from this recording's stream, if the provider supports it. */
+    snapshot?(outputPath: string): Promise<Record<string, unknown>>;
+}
+export interface VideoRecordingResult {
+    recorder?: RecipeArtifactManifestEntry['recorder'];
+    timing?: import('@farmslot/protocol').RecipeVideoTiming;
+    timingUnavailableReason?: string;
+    /** Raw provider timing evidence, relative to the private video staging directory. */
+    timingEvidencePath?: string;
+}
+export interface VideoRecorder {
+    name: string;
+    version?: string;
+    platform?: string;
+    doctor?(): Promise<VideoRecorderDoctorResult>;
+    start(request: VideoRecorderStartRequest): Promise<ActiveVideoRecording>;
+}
+export interface VideoRecorderDoctorResult {
+    ok: boolean;
+    code: string;
+    message: string;
+    suggestedFix?: string;
+}
+export interface RecipeHudOptions {
+    enabled?: boolean;
+    title?: string;
+    display?: RecipeHudDisplayOptions;
+}
+export interface RecipeHudDisplayOptions {
+    layout?: 'bottom-bar' | 'docked-bottom' | 'card';
+    position?: 'bottom' | 'top' | 'bottom-right' | 'bottom-left' | 'top-right' | 'top-left';
+    showTitle?: boolean;
+    /** Show node/action/proof metadata. Hidden by default because HUD copy is for humans, not trace/debug labels. */
+    showDebug?: boolean;
+    /** Show authored detail as a second HUD line. Hidden by default because detail is trace/review metadata, not the current intent. */
+    showDetail?: boolean;
+    maxDetailLines?: number;
+    width?: string;
+}
+export interface ActionResult {
+    case?: string;
+    output?: unknown;
+    artifacts?: RecipeArtifactManifestEntry[];
+    phases?: RecipeActionPhase[];
+    observations?: RecipeObservations;
+    observationWarnings?: RecipeObservationWarning[];
+}
+export interface RecipeActionPhase {
+    phase: 'start' | 'move' | 'end';
+    x: number;
+    y: number;
+    elapsedMs: number;
+}
+export interface ActionExecutionContext {
+    nodeId: string;
+    recipe: unknown;
+    projectRoot: string;
+    artifactsDir: string;
+    env: Record<string, string | undefined>;
+    outputs: ReadonlyMap<string, unknown>;
+    getOutput(nodeId: string): unknown;
+    resolveProjectPath(relativePath: string): string;
+    resolveArtifactPath(relativePath: string): string;
+    getRunFileOffset(relativePath: string): number | undefined;
+    registerArtifact(entry: RecipeArtifactManifestEntry): void;
+    captureRecordingSnapshot?(relativePath: string): Promise<Record<string, unknown>>;
+    logger: RecipeLogger;
+}
+export interface ActionAdapter {
+    action: string;
+    testOnly?: boolean;
+    capabilities?: RecipeExecutionCapability[];
+    source?: RecipeSourceProvenance;
+    resolveSourceDigest?: () => Promise<string>;
+    execute(node: Record<string, unknown>, context: ActionExecutionContext): Promise<ActionResult>;
+    observe?(refs: readonly UiObserverRef[], node: Record<string, unknown>, context: ActionExecutionContext): Promise<RecipeObservationResult>;
+}
+export type RecipeObservations = Partial<Record<UiObserverRef, unknown>>;
+export interface RecipeObservationWarning {
+    ref: UiObserverRef;
+    message: string;
+}
+export interface RecipeObservationResult {
+    observations?: RecipeObservations;
+    warnings?: RecipeObservationWarning[];
+}
+export interface RecipeCallTrace {
+    ref: string;
+    digest: string;
+    source: string;
+    file: string;
+    adapter?: string;
+}
+export interface ArtifactWriter {
+    copyRecipe(recipe: unknown): Promise<string>;
+    copyResolvedRecipe(digest: string, recipe: unknown): Promise<string>;
+    writeRecipeResolution(resolution: RecipeResolutionDocument): Promise<string>;
+    register(entry: RecipeArtifactManifestEntry): void;
+    list(): RecipeArtifactManifestEntry[];
+    write(status: RecipeRunStatus, runner?: RecipeRunnerProvenance): Promise<string>;
+}
+export interface TraceEntry {
+    nodeId: string;
+    action: string;
+    recipe?: RecipeCallTrace;
+    intent?: string;
+    proves?: string[];
+    startedAt: string;
+    endedAt: string;
+    durationMs: number;
+    ok: boolean;
+    cause_class?: RecipeFailureCause;
+    next?: string;
+    status?: RecipeRunStatus;
+    case?: string;
+    output?: unknown;
+    phases?: RecipeActionPhase[];
+    observations?: RecipeObservations;
+    observationWarnings?: RecipeObservationWarning[];
+    artifacts?: RecipeArtifactManifestEntry[];
+    error?: string;
+    /** Stable failure code, for example SCROLL_TARGET_NOT_VISIBLE. */
+    error_code?: string;
+    /** Observation preserved from the failed node, such as ui.scroll_to geometry. */
+    error_details?: unknown;
+}
+export interface TraceWriter {
+    record(entry: TraceEntry): void;
+    list(): TraceEntry[];
+    write(): Promise<string>;
+}
+export interface SummaryDocument {
+    /** Digest of the retained, redacted execution inputs when recorded. */
+    invocationDigest?: string;
+    status: RecipeRunStatus;
+    total: number;
+    passed: number;
+    failed: number;
+    cause_counts: Record<RecipeFailureCause, number>;
+    startedAt: string;
+    endedAt: string;
+    durationMs: number;
+    harness: {
+        name: '@farmslot/recipe-runner';
+        version: string;
+        action_manifest_schema: string;
+    };
+    runner?: RecipeRunnerProvenance;
+    /** Present when recipe library sources were configured for the run. */
+    recipeLibraries?: RecipeLibrarySummary;
+    /** Present when the caller selected a library recipe by name. */
+    recipeSelection?: RecipeSelection;
+    /** Present when the run was partial; the root graph stopped after this node. */
+    stopAfterNode?: string;
+}
+export interface SummaryWriter {
+    write(summary: SummaryDocument): Promise<string>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/core/types.d.ts.map

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

package/dist/core/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":""}

package/dist/core/validation.d.ts

@@ -0,0 +1,4 @@
+import { type RecipeActionManifestDocument, type RecipeDocumentValidationOptions } from '@farmslot/protocol';
+export declare function assertManifestIsValid(manifest: unknown): asserts manifest is RecipeActionManifestDocument;
+export declare function assertRecipeMatchesManifest(recipe: unknown, manifest: RecipeActionManifestDocument, options?: RecipeDocumentValidationOptions): void;
+//# sourceMappingURL=validation.d.ts.map

package/dist/core/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/core/validation.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,4BAA4B,EACjC,KAAK,+BAA+B,EAGrC,MAAM,oBAAoB,CAAC;AAE5B,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,OAAO,GAChB,OAAO,CAAC,QAAQ,IAAI,4BAA4B,CASlD;AAED,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,OAAO,EACf,QAAQ,EAAE,4BAA4B,EACtC,OAAO,CAAC,EAAE,+BAA+B,GACxC,IAAI,CASN"}

package/dist/core/validation.js

@@ -0,0 +1,18 @@
+import { validateRecipeActionManifestDocument, validateRecipeWithManifest, } from '@farmslot/protocol';
+export function assertManifestIsValid(manifest) {
+    const result = validateRecipeActionManifestDocument(manifest);
+    if (result.status === 'invalid') {
+        throw new Error(`Recipe action manifest is invalid: ${result.findings
+            .map((finding) => `${finding.code} ${finding.path}: ${finding.message}`)
+            .join('; ')}`);
+    }
+}
+export function assertRecipeMatchesManifest(recipe, manifest, options) {
+    const result = validateRecipeWithManifest(recipe, manifest, options);
+    if (result.status === 'invalid') {
+        throw new Error(`Recipe is invalid for the action manifest: ${result.findings
+            .map((finding) => `${finding.code} ${finding.path}: ${finding.message}`)
+            .join('; ')}`);
+    }
+}
+//# sourceMappingURL=validation.js.map

package/dist/core/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../src/core/validation.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,oCAAoC,EACpC,0BAA0B,GAC3B,MAAM,oBAAoB,CAAC;AAE5B,MAAM,UAAU,qBAAqB,CACnC,QAAiB;IAEjB,MAAM,MAAM,GAAG,oCAAoC,CAAC,QAAQ,CAAC,CAAC;IAC9D,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CACb,sCAAsC,MAAM,CAAC,QAAQ;aAClD,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,KAAK,OAAO,CAAC,OAAO,EAAE,CAAC;aACvE,IAAI,CAAC,IAAI,CAAC,EAAE,CAChB,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,2BAA2B,CACzC,MAAe,EACf,QAAsC,EACtC,OAAyC;IAEzC,MAAM,MAAM,GAAG,0BAA0B,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;IACrE,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CACb,8CAA8C,MAAM,CAAC,QAAQ;aAC1D,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,KAAK,OAAO,CAAC,OAAO,EAAE,CAAC;aACvE,IAAI,CAAC,IAAI,CAAC,EAAE,CAChB,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,32 @@
+export type { AppLifecycleCommand, AppLifecycleCommandRunner, AppLifecyclePlatform, AppLifecycleTarget, AppLifecycleTargetProvider, CreateAppLifecycleAdapterOptions, } from './adapters/app-lifecycle.js';
+export { createAppLifecycleAdapter, createAppLifecycleAdapters } from './adapters/app-lifecycle.js';
+export { createStandardCoreAdapters } from './adapters/core.js';
+export { type GestureAction, gestureDurationMs, gesturePhase, gesturePoints, gestureSegmentDuration, gestureTarget, type UiPoint, } from './adapters/gesture.js';
+export type { StandardUiAction, UiActionTransport, UiTransportControl, UiTransportResult, } from './adapters/ui.js';
+export { createStandardUiAdapters, normalizeUiTransportResult, STANDARD_UI_ACTIONS, } from './adapters/ui.js';
+export { type ResolvedRecipeDependencies, resolveRecipeDependencies, rootResolutionRef, validateRecipeDependencyParams, } from './core/compose.js';
+export { RecipeExecutionError } from './core/failure.js';
+export { extractWorkflowGraph, type WorkflowGraph } from './core/graph.js';
+export { redactRecipeParams } from './core/invocation.js';
+export type { LibraryRecipeMatch, RecipeLibraryEnv, RecipeLibraryLoadOptions, RecipeLibraryResolution, ResolvedLibraryRecipe, } from './core/library.js';
+export { applyTaskLocalInvocationTrust, BUILT_IN_RECIPE_PLATFORMS, defaultRecipeLibrarySources, findLibraryRecipe, listRecipeFiles, listRecipeLibraryPlatforms, loadRecipeLibraries, logRecipeLibraryResolution, logRecipeLibraryShadows, logRecipeLibrarySources, parseRecipeLibraryPath, personalRecipeLibraryRoot, resolveRecipeLibrarySources, } from './core/library.js';
+export { checkRecipeLibraryRequirements, digestRecipeLibrary, listLibraryFiles, readRecipeLibraryManifest, RECIPE_LIBRARY_DIRECTORIES, RECIPE_LIBRARY_MANIFEST_FILE, type RecipeLibraryAdapterDeclaration, type RecipeLibraryManifest, type RecipeLibraryRequirement, type RecipePackageVersions, SHARED_RECIPE_SCOPE, } from './core/library-manifest.js';
+export { resolveRecipeParams, resolveRecipeValue } from './core/parameters.js';
+export { RecipeResolutionError } from './core/resolution-error.js';
+export { createRecipeRunner, defineActionAdapter } from './core/runner.js';
+export { isVisibleWithin, parseUiScrollToRequest, runUiScrollTo, safeViewportFor, UI_SCROLL_TO_ERROR_CODES, type UiRect, type UiScrollGeometry, type UiScrollOffset, type UiScrollSession, type UiScrollSettlement, type UiScrollSnapshot, UiScrollToError, type UiScrollToErrorCode, type UiScrollToObservation, type UiScrollToRequest, } from './core/scroll-to.js';
+export { finalizeRecipeSuite, type FinalizeRecipeSuiteRequest, freezeRecipeSuiteScope, type RecipeSuiteFinalizeResult, type RecipeSuiteResolutionInput, type RecipeSuiteScopeSnapshot, type RecipeSuiteVerdictInput, } from './core/suite.js';
+export { buildRecipeExecutionPlan, enforceRecipeExecutionPlan, recipeSourceForRequest, } from './core/trust.js';
+export { RecipeTrustError } from './core/trust-error.js';
+export { RECIPE_TRUST_ENV, resolveRecipeTrustInput } from './core/trust-input.js';
+export type * from './core/types.js';
+export { createAndroidMirrorVideoRecorder } from './recording/android-mirror.js';
+export type { CaptureHelperVideoRecorderOptions } from './recording/capture-helper.js';
+export { createCaptureHelperVideoRecorder, errorMessage, manifestTarget, } from './recording/capture-helper.js';
+export { readCaptureHelperTiming } from './recording/capture-helper-timing.js';
+export type { CdpVideoRecorderOptions } from './recording/cdp-video-recorder.js';
+export { createCdpVideoRecorder } from './recording/cdp-video-recorder.js';
+export { createRecordingTimeline, optionalVideoTiming, probeVideoTiming, writeRecordingTimeline, } from './recording/timeline.js';
+export { RECIPE_RUNNER_VERSION } from './version.js';
+export type { RecipeResolutionDependency, RecipeResolutionDocument, RecipeResolutionEdge, } from '@farmslot/protocol';
+//# 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":"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"}

package/dist/index.js

@@ -0,0 +1,25 @@
+export { createAppLifecycleAdapter, createAppLifecycleAdapters } from './adapters/app-lifecycle.js';
+export { createStandardCoreAdapters } from './adapters/core.js';
+export { gestureDurationMs, gesturePhase, gesturePoints, gestureSegmentDuration, gestureTarget, } from './adapters/gesture.js';
+export { createStandardUiAdapters, normalizeUiTransportResult, STANDARD_UI_ACTIONS, } from './adapters/ui.js';
+export { resolveRecipeDependencies, rootResolutionRef, validateRecipeDependencyParams, } from './core/compose.js';
+export { RecipeExecutionError } from './core/failure.js';
+export { extractWorkflowGraph } from './core/graph.js';
+export { redactRecipeParams } from './core/invocation.js';
+export { applyTaskLocalInvocationTrust, BUILT_IN_RECIPE_PLATFORMS, defaultRecipeLibrarySources, findLibraryRecipe, listRecipeFiles, listRecipeLibraryPlatforms, loadRecipeLibraries, logRecipeLibraryResolution, logRecipeLibraryShadows, logRecipeLibrarySources, parseRecipeLibraryPath, personalRecipeLibraryRoot, resolveRecipeLibrarySources, } from './core/library.js';
+export { checkRecipeLibraryRequirements, digestRecipeLibrary, listLibraryFiles, readRecipeLibraryManifest, RECIPE_LIBRARY_DIRECTORIES, RECIPE_LIBRARY_MANIFEST_FILE, SHARED_RECIPE_SCOPE, } from './core/library-manifest.js';
+export { resolveRecipeParams, resolveRecipeValue } from './core/parameters.js';
+export { RecipeResolutionError } from './core/resolution-error.js';
+export { createRecipeRunner, defineActionAdapter } from './core/runner.js';
+export { isVisibleWithin, parseUiScrollToRequest, runUiScrollTo, safeViewportFor, UI_SCROLL_TO_ERROR_CODES, UiScrollToError, } from './core/scroll-to.js';
+export { finalizeRecipeSuite, freezeRecipeSuiteScope, } from './core/suite.js';
+export { buildRecipeExecutionPlan, enforceRecipeExecutionPlan, recipeSourceForRequest, } from './core/trust.js';
+export { RecipeTrustError } from './core/trust-error.js';
+export { RECIPE_TRUST_ENV, resolveRecipeTrustInput } from './core/trust-input.js';
+export { createAndroidMirrorVideoRecorder } from './recording/android-mirror.js';
+export { createCaptureHelperVideoRecorder, errorMessage, manifestTarget, } from './recording/capture-helper.js';
+export { readCaptureHelperTiming } from './recording/capture-helper-timing.js';
+export { createCdpVideoRecorder } from './recording/cdp-video-recorder.js';
+export { createRecordingTimeline, optionalVideoTiming, probeVideoTiming, writeRecordingTimeline, } from './recording/timeline.js';
+export { RECIPE_RUNNER_VERSION } from './version.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,yBAAyB,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAC;AACpG,OAAO,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,EAEL,iBAAiB,EACjB,YAAY,EACZ,aAAa,EACb,sBAAsB,EACtB,aAAa,GAEd,MAAM,uBAAuB,CAAC;AAO/B,OAAO,EACL,wBAAwB,EACxB,0BAA0B,EAC1B,mBAAmB,GACpB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAEL,yBAAyB,EACzB,iBAAiB,EACjB,8BAA8B,GAC/B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAsB,MAAM,iBAAiB,CAAC;AAC3E,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAQ1D,OAAO,EACL,6BAA6B,EAC7B,yBAAyB,EACzB,2BAA2B,EAC3B,iBAAiB,EACjB,eAAe,EACf,0BAA0B,EAC1B,mBAAmB,EACnB,0BAA0B,EAC1B,uBAAuB,EACvB,uBAAuB,EACvB,sBAAsB,EACtB,yBAAyB,EACzB,2BAA2B,GAC5B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,8BAA8B,EAC9B,mBAAmB,EACnB,gBAAgB,EAChB,yBAAyB,EACzB,0BAA0B,EAC1B,4BAA4B,EAK5B,mBAAmB,GACpB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC/E,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC3E,OAAO,EACL,eAAe,EACf,sBAAsB,EACtB,aAAa,EACb,eAAe,EACf,wBAAwB,EAOxB,eAAe,GAIhB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,mBAAmB,EAEnB,sBAAsB,GAKvB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,wBAAwB,EACxB,0BAA0B,EAC1B,sBAAsB,GACvB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAElF,OAAO,EAAE,gCAAgC,EAAE,MAAM,+BAA+B,CAAC;AAEjF,OAAO,EACL,gCAAgC,EAChC,YAAY,EACZ,cAAc,GACf,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAC;AAE/E,OAAO,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAC3E,OAAO,EACL,uBAAuB,EACvB,mBAAmB,EACnB,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC"}

package/dist/node/writers.d.ts

@@ -0,0 +1,27 @@
+import { type RecipeArtifactManifestEntry, type RecipeResolutionDocument } from '@farmslot/protocol';
+import type { RecipeInvocationDocument } from '../core/invocation.js';
+import type { ArtifactWriter, RecipeRunnerProvenance, RecipeRunStatus, SummaryDocument, SummaryWriter, TraceEntry, TraceWriter } from '../core/types.js';
+export declare class JsonArtifactWriter implements ArtifactWriter {
+    #private;
+    constructor(artifactsDir: string);
+    copyRecipe(recipe: unknown): Promise<string>;
+    copyResolvedRecipe(digest: string, recipe: unknown): Promise<string>;
+    writeRecipeResolution(resolution: RecipeResolutionDocument): Promise<string>;
+    writeInvocation(invocation: RecipeInvocationDocument): Promise<void>;
+    register(entry: RecipeArtifactManifestEntry): void;
+    list(): RecipeArtifactManifestEntry[];
+    write(status: RecipeRunStatus, runner?: RecipeRunnerProvenance): Promise<string>;
+}
+export declare class JsonTraceWriter implements TraceWriter {
+    #private;
+    constructor(artifactsDir: string, runner?: RecipeRunnerProvenance);
+    record(entry: TraceEntry): void;
+    list(): TraceEntry[];
+    write(): Promise<string>;
+}
+export declare class JsonSummaryWriter implements SummaryWriter {
+    #private;
+    constructor(artifactsDir: string);
+    write(summary: SummaryDocument): Promise<string>;
+}
+//# sourceMappingURL=writers.d.ts.map

package/dist/node/writers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"writers.d.ts","sourceRoot":"","sources":["../../src/node/writers.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,2BAA2B,EAChC,KAAK,wBAAwB,EAE9B,MAAM,oBAAoB,CAAC;AAE5B,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AAEtE,OAAO,KAAK,EACV,cAAc,EACd,sBAAsB,EACtB,eAAe,EACf,eAAe,EACf,aAAa,EACb,UAAU,EACV,WAAW,EACZ,MAAM,kBAAkB,CAAC;AAE1B,qBAAa,kBAAmB,YAAW,cAAc;;gBAI3C,YAAY,EAAE,MAAM;IAI1B,UAAU,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC;IAW5C,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC;IAapE,qBAAqB,CAAC,UAAU,EAAE,wBAAwB,GAAG,OAAO,CAAC,MAAM,CAAC;IAY5E,eAAe,CAAC,UAAU,EAAE,wBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC;IAU1E,QAAQ,CAAC,KAAK,EAAE,2BAA2B,GAAG,IAAI;IAMlD,IAAI,IAAI,2BAA2B,EAAE;IAI/B,KAAK,CAAC,MAAM,EAAE,eAAe,EAAE,MAAM,CAAC,EAAE,sBAAsB,GAAG,OAAO,CAAC,MAAM,CAAC;CAQvF;AAED,qBAAa,eAAgB,YAAW,WAAW;;gBAKrC,YAAY,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,sBAAsB;IAKjE,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAI/B,IAAI,IAAI,UAAU,EAAE;IAId,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC;CAO/B;AAED,qBAAa,iBAAkB,YAAW,aAAa;;gBAGzC,YAAY,EAAE,MAAM;IAI1B,KAAK,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC;CAGvD"}

package/dist/node/writers.js

@@ -0,0 +1,99 @@
+import { resolvedRecipeArtifactPath, } from '@farmslot/protocol';
+import { writeFileWithinRoot } from '../core/path.js';
+export class JsonArtifactWriter {
+    #artifactsDir;
+    #entries = [];
+    constructor(artifactsDir) {
+        this.#artifactsDir = artifactsDir;
+    }
+    async copyRecipe(recipe) {
+        const recipePath = await writeJsonWithinRoot(this.#artifactsDir, 'recipe.json', recipe);
+        this.register({
+            path: 'recipe.json',
+            type: 'recipe',
+            label: 'Executed recipe',
+            category: 'system',
+        });
+        return recipePath;
+    }
+    async copyResolvedRecipe(digest, recipe) {
+        const relativePath = resolvedRecipeArtifactPath(digest);
+        if (!relativePath)
+            throw new Error(`Invalid resolved recipe digest ${digest}.`);
+        const resolvedPath = await writeJsonWithinRoot(this.#artifactsDir, relativePath, recipe);
+        this.register({
+            path: relativePath,
+            type: 'recipe',
+            label: 'Resolved recipe dependency',
+            category: 'system',
+        });
+        return resolvedPath;
+    }
+    async writeRecipeResolution(resolution) {
+        const relativePath = 'recipe-resolution.json';
+        const resolutionPath = await writeJsonWithinRoot(this.#artifactsDir, relativePath, resolution);
+        this.register({
+            path: relativePath,
+            type: 'json',
+            label: 'Resolved recipe dependency graph',
+            category: 'system',
+        });
+        return resolutionPath;
+    }
+    async writeInvocation(invocation) {
+        await writeJsonWithinRoot(this.#artifactsDir, 'recipe-invocation.json', invocation);
+        this.register({
+            path: 'recipe-invocation.json',
+            type: 'json',
+            label: 'Executed recipe parameters',
+            category: 'system',
+        });
+    }
+    register(entry) {
+        if (!this.#entries.some((existing) => existing.path === entry.path)) {
+            this.#entries.push(entry);
+        }
+    }
+    list() {
+        return [...this.#entries];
+    }
+    async write(status, runner) {
+        return writeJsonWithinRoot(this.#artifactsDir, 'artifact-manifest.json', {
+            version: 1,
+            runStatus: status,
+            ...(runner ? { provenance: { runner } } : {}),
+            artifacts: this.list(),
+        });
+    }
+}
+export class JsonTraceWriter {
+    #artifactsDir;
+    #entries = [];
+    #runner;
+    constructor(artifactsDir, runner) {
+        this.#artifactsDir = artifactsDir;
+        this.#runner = runner;
+    }
+    record(entry) {
+        this.#entries.push(entry);
+    }
+    list() {
+        return [...this.#entries];
+    }
+    async write() {
+        return writeJsonWithinRoot(this.#artifactsDir, 'trace.json', this.#runner ? { metadata: { runner: this.#runner }, entries: this.list() } : this.list());
+    }
+}
+export class JsonSummaryWriter {
+    #artifactsDir;
+    constructor(artifactsDir) {
+        this.#artifactsDir = artifactsDir;
+    }
+    async write(summary) {
+        return writeJsonWithinRoot(this.#artifactsDir, 'summary.json', summary);
+    }
+}
+function writeJsonWithinRoot(root, relativePath, value) {
+    return writeFileWithinRoot(root, relativePath, `${JSON.stringify(value, null, 2)}\n`);
+}
+//# sourceMappingURL=writers.js.map

package/dist/node/writers.js.map

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

package/dist/recording/android-mirror.d.ts

@@ -0,0 +1,10 @@
+import type { VideoRecorder } from '../core/types.js';
+/** The caller must hold the device lease. This recorder owns only its scrcpy
+ * process and exact window; it never installs, unlocks, or controls the device. */
+export declare function createAndroidMirrorVideoRecorder(options: {
+    serial: string;
+    fallback: VideoRecorder;
+    scrcpyPath?: string;
+    captureHelperPath?: string;
+}): VideoRecorder;
+//# sourceMappingURL=android-mirror.d.ts.map

package/dist/recording/android-mirror.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"android-mirror.d.ts","sourceRoot":"","sources":["../../src/recording/android-mirror.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAEV,aAAa,EAGd,MAAM,kBAAkB,CAAC;AAM1B;mFACmF;AACnF,wBAAgB,gCAAgC,CAAC,OAAO,EAAE;IACxD,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,aAAa,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B,GAAG,aAAa,CA0KhB"}