@vibesdotdev/media 0.0.0-stage → 1.0.0-rc.3

package/dist/schemas/motion-analysis.d.ts

@@ -0,0 +1,187 @@
+/**
+ * Motion Analysis Options + Result Schemas
+ *
+ * The option/result shapes for each `MotionAnalyzer` primitive. Per-pixel
+ * maps (`Float32Array`) are opt-in (`includeMap` / `includeMaps`) because
+ * they are large; scalar summaries are always returned so agents and vision
+ * models can branch on a compact JSON payload.
+ */
+import * as z from 'zod/v4';
+/** A rectangular region in downscaled-analysis pixel space. */
+export declare const RegionSchema: z.ZodObject<{
+    x: z.ZodNumber;
+    y: z.ZodNumber;
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+}, z.core.$strip>;
+export type Region = z.infer<typeof RegionSchema>;
+/** Options for `frameDiff(a, b)`. */
+export declare const FrameDiffOptionsSchema: z.ZodObject<{
+    downscale: z.ZodOptional<z.ZodNumber>;
+    threshold: z.ZodOptional<z.ZodNumber>;
+    includeMap: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type FrameDiffOptions = z.infer<typeof FrameDiffOptionsSchema>;
+/** Result of `frameDiff(a, b)`. */
+export declare const FrameDiffResultSchema: z.ZodObject<{
+    magnitude: z.ZodNumber;
+    changedFraction: z.ZodNumber;
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+    bbox: z.ZodNullable<z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+    }, z.core.$strip>>;
+    map: z.ZodOptional<z.ZodInstanceOf<Float32Array<ArrayBuffer>>>;
+}, z.core.$strip>;
+export type FrameDiffResult = z.infer<typeof FrameDiffResultSchema>;
+/** Options for `temporalStats(frames)`. */
+export declare const TemporalStatsOptionsSchema: z.ZodObject<{
+    downscale: z.ZodOptional<z.ZodNumber>;
+    includeMaps: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type TemporalStatsOptions = z.infer<typeof TemporalStatsOptionsSchema>;
+/**
+ * Result of `temporalStats(frames)`.
+ *
+ * The per-pixel temporal standard deviation is the cheapest "does anything
+ * move here" statistic — it is exactly the naive aggregation that leaks a
+ * ghost of hidden structure even without a motion model.
+ */
+export declare const TemporalStatsResultSchema: z.ZodObject<{
+    meanStd: z.ZodNumber;
+    peakStd: z.ZodNumber;
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+    std: z.ZodOptional<z.ZodInstanceOf<Float32Array<ArrayBuffer>>>;
+    mean: z.ZodOptional<z.ZodInstanceOf<Float32Array<ArrayBuffer>>>;
+}, z.core.$strip>;
+export type TemporalStatsResult = z.infer<typeof TemporalStatsResultSchema>;
+/** Options for `opticalFlow(a, b)` (block-matching). */
+export declare const OpticalFlowOptionsSchema: z.ZodObject<{
+    downscale: z.ZodOptional<z.ZodNumber>;
+    blockSize: z.ZodOptional<z.ZodNumber>;
+    searchRadius: z.ZodOptional<z.ZodNumber>;
+    step: z.ZodOptional<z.ZodNumber>;
+    minConfidence: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type OpticalFlowOptions = z.infer<typeof OpticalFlowOptionsSchema>;
+/** A single block-motion estimate. */
+export declare const FlowVectorSchema: z.ZodObject<{
+    x: z.ZodNumber;
+    y: z.ZodNumber;
+    dx: z.ZodNumber;
+    dy: z.ZodNumber;
+    confidence: z.ZodNumber;
+}, z.core.$strip>;
+export type FlowVector = z.infer<typeof FlowVectorSchema>;
+/** Result of `opticalFlow(a, b)`. */
+export declare const OpticalFlowResultSchema: z.ZodObject<{
+    vectors: z.ZodArray<z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        dx: z.ZodNumber;
+        dy: z.ZodNumber;
+        confidence: z.ZodNumber;
+    }, z.core.$strip>>;
+    meanDx: z.ZodNumber;
+    meanDy: z.ZodNumber;
+    meanConfidence: z.ZodNumber;
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+    blockSize: z.ZodNumber;
+}, z.core.$strip>;
+export type OpticalFlowResult = z.infer<typeof OpticalFlowResultSchema>;
+/** A candidate motion direction (integer per-frame shift, analysis pixels). */
+export declare const MotionDirectionSchema: z.ZodObject<{
+    dx: z.ZodNumber;
+    dy: z.ZodNumber;
+}, z.core.$strip>;
+export type MotionDirection = z.infer<typeof MotionDirectionSchema>;
+/** Options for `motionEnergy(frames)` (Reichardt / lag-1 cross-correlation). */
+export declare const MotionEnergyOptionsSchema: z.ZodObject<{
+    downscale: z.ZodOptional<z.ZodNumber>;
+    maxDim: z.ZodOptional<z.ZodNumber>;
+    directions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        dx: z.ZodNumber;
+        dy: z.ZodNumber;
+    }, z.core.$strip>>>;
+    shiftRadius: z.ZodOptional<z.ZodNumber>;
+    includeMap: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type MotionEnergyOptions = z.infer<typeof MotionEnergyOptionsSchema>;
+/** Strength of coherent motion in one candidate direction. */
+export declare const DirectionStrengthSchema: z.ZodObject<{
+    dx: z.ZodNumber;
+    dy: z.ZodNumber;
+    strength: z.ZodNumber;
+}, z.core.$strip>;
+export type DirectionStrength = z.infer<typeof DirectionStrengthSchema>;
+/**
+ * Result of `motionEnergy(frames)`.
+ *
+ * `coherence` is the discriminator the passage turns on: coherently drifting
+ * structure scores high, temporally independent twinkle scores ~0, because
+ * the opponent (Reichardt) subtraction cancels non-directional correlation.
+ */
+export declare const MotionEnergyResultSchema: z.ZodObject<{
+    coherence: z.ZodNumber;
+    dominant: z.ZodObject<{
+        dx: z.ZodNumber;
+        dy: z.ZodNumber;
+        strength: z.ZodNumber;
+    }, z.core.$strip>;
+    perDirection: z.ZodArray<z.ZodObject<{
+        dx: z.ZodNumber;
+        dy: z.ZodNumber;
+        strength: z.ZodNumber;
+    }, z.core.$strip>>;
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+    map: z.ZodOptional<z.ZodInstanceOf<Float32Array<ArrayBuffer>>>;
+}, z.core.$strip>;
+export type MotionEnergyResult = z.infer<typeof MotionEnergyResultSchema>;
+/** Coarse classification of what a frame sequence is doing. */
+export declare const MotionVerdictSchema: z.ZodUnion<readonly [z.ZodLiteral<"static">, z.ZodLiteral<"coherent-motion">, z.ZodLiteral<"incoherent-change">]>;
+export type MotionVerdict = z.infer<typeof MotionVerdictSchema>;
+/** Options for `summarize(frames)`. */
+export declare const MotionSummaryOptionsSchema: z.ZodObject<{
+    downscale: z.ZodOptional<z.ZodNumber>;
+    coherenceThreshold: z.ZodOptional<z.ZodNumber>;
+    staticThreshold: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type MotionSummaryOptions = z.infer<typeof MotionSummaryOptionsSchema>;
+/**
+ * Compact, agent-facing summary of a frame sequence — "what happened between
+ * these samples" distilled to a payload a vision model or planner can act on.
+ */
+export declare const MotionSummarySchema: z.ZodObject<{
+    frameCount: z.ZodNumber;
+    changed: z.ZodObject<{
+        magnitude: z.ZodNumber;
+        changedFraction: z.ZodNumber;
+        bbox: z.ZodNullable<z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+    motion: z.ZodObject<{
+        coherence: z.ZodNumber;
+        dominant: z.ZodObject<{
+            dx: z.ZodNumber;
+            dy: z.ZodNumber;
+            strength: z.ZodNumber;
+        }, z.core.$strip>;
+    }, z.core.$strip>;
+    temporal: z.ZodObject<{
+        meanStd: z.ZodNumber;
+        peakStd: z.ZodNumber;
+    }, z.core.$strip>;
+    verdict: z.ZodUnion<readonly [z.ZodLiteral<"static">, z.ZodLiteral<"coherent-motion">, z.ZodLiteral<"incoherent-change">]>;
+}, z.core.$strip>;
+export type MotionSummary = z.infer<typeof MotionSummarySchema>;
+//# sourceMappingURL=motion-analysis.d.ts.map

package/dist/schemas/motion-analysis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"motion-analysis.d.ts","sourceRoot":"","sources":["../../src/schemas/motion-analysis.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B,+DAA+D;AAC/D,eAAO,MAAM,YAAY;;;;;iBAKvB,CAAC;AAEH,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAIlD,qCAAqC;AACrC,eAAO,MAAM,sBAAsB;;;;iBAYjC,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,mCAAmC;AACnC,eAAO,MAAM,qBAAqB;;;;;;;;;;;;iBAkBhC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAIpE,2CAA2C;AAC3C,eAAO,MAAM,0BAA0B;;;iBAMrC,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E;;;;;;GAMG;AACH,eAAO,MAAM,yBAAyB;;;;;;;iBAkBpC,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAI5E,wDAAwD;AACxD,eAAO,MAAM,wBAAwB;;;;;;iBAenC,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,sCAAsC;AACtC,eAAO,MAAM,gBAAgB;;;;;;iBAW3B,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,qCAAqC;AACrC,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;iBAqBlC,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAIxE,+EAA+E;AAC/E,eAAO,MAAM,qBAAqB;;;iBAGhC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,gFAAgF;AAChF,eAAO,MAAM,yBAAyB;;;;;;;;;iBAqBpC,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E,8DAA8D;AAC9D,eAAO,MAAM,uBAAuB;;;;iBAKlC,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;iBAkBnC,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAI1E,+DAA+D;AAC/D,eAAO,MAAM,mBAAmB,mHAI9B,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,uCAAuC;AACvC,eAAO,MAAM,0BAA0B;;;;iBASrC,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E;;;GAGG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;iBAyB9B,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC"}

package/dist/schemas/motion-analysis.js

@@ -0,0 +1,213 @@
+/**
+ * Motion Analysis Options + Result Schemas
+ *
+ * The option/result shapes for each `MotionAnalyzer` primitive. Per-pixel
+ * maps (`Float32Array`) are opt-in (`includeMap` / `includeMaps`) because
+ * they are large; scalar summaries are always returned so agents and vision
+ * models can branch on a compact JSON payload.
+ */
+import * as z from 'zod/v4';
+/** A rectangular region in downscaled-analysis pixel space. */
+export const RegionSchema = z.object({
+    x: z.number().int().nonnegative(),
+    y: z.number().int().nonnegative(),
+    width: z.number().int().positive(),
+    height: z.number().int().positive()
+});
+// ── frameDiff ──────────────────────────────────────────────────────────────
+/** Options for `frameDiff(a, b)`. */
+export const FrameDiffOptionsSchema = z.object({
+    /** Integer downscale factor applied before diffing (1 = native). Speeds up large frames. */
+    downscale: z.number().int().positive().optional(),
+    /**
+     * Per-pixel absolute-luma-difference threshold (0..1) above which a pixel
+     * counts as "changed" for `changedFraction` / `bbox`. Default 0.08.
+     */
+    threshold: z.number().min(0).max(1).optional(),
+    /** Include the per-pixel normalized diff map in the result. */
+    includeMap: z.boolean().optional()
+});
+/** Result of `frameDiff(a, b)`. */
+export const FrameDiffResultSchema = z.object({
+    /** Mean absolute luma difference across the frame, normalized to 0..1. */
+    magnitude: z.number().min(0).max(1),
+    /** Fraction of pixels whose change exceeded `threshold` (0..1). */
+    changedFraction: z.number().min(0).max(1),
+    /** Analysis-space width (after downscale). */
+    width: z.number().int().positive(),
+    /** Analysis-space height (after downscale). */
+    height: z.number().int().positive(),
+    /** Tight bounding box of changed pixels, or null when nothing changed. */
+    bbox: RegionSchema.nullable(),
+    /** Per-pixel normalized abs-diff map (0..1), row-major. Present iff `includeMap`. */
+    map: z.instanceof(Float32Array).optional()
+});
+// ── temporalStats ────────────────────────────────────────────────────────────
+/** Options for `temporalStats(frames)`. */
+export const TemporalStatsOptionsSchema = z.object({
+    /** Integer downscale factor (1 = native). */
+    downscale: z.number().int().positive().optional(),
+    /** Include per-pixel mean + std maps in the result. */
+    includeMaps: z.boolean().optional()
+});
+/**
+ * Result of `temporalStats(frames)`.
+ *
+ * The per-pixel temporal standard deviation is the cheapest "does anything
+ * move here" statistic — it is exactly the naive aggregation that leaks a
+ * ghost of hidden structure even without a motion model.
+ */
+export const TemporalStatsResultSchema = z.object({
+    /** Mean per-pixel temporal std across the frame, normalized 0..1. */
+    meanStd: z.number().min(0).max(1),
+    /** Maximum per-pixel temporal std, normalized 0..1. */
+    peakStd: z.number().min(0).max(1),
+    /** Analysis-space width. */
+    width: z.number().int().positive(),
+    /** Analysis-space height. */
+    height: z.number().int().positive(),
+    /** Per-pixel temporal std map (0..1). Present iff `includeMaps`. */
+    std: z.instanceof(Float32Array).optional(),
+    /** Per-pixel temporal mean map (0..1). Present iff `includeMaps`. */
+    mean: z.instanceof(Float32Array).optional()
+});
+// ── opticalFlow ──────────────────────────────────────────────────────────────
+/** Options for `opticalFlow(a, b)` (block-matching). */
+export const OpticalFlowOptionsSchema = z.object({
+    /** Integer downscale factor (1 = native). */
+    downscale: z.number().int().positive().optional(),
+    /** Square block edge length in analysis pixels. Default 16. */
+    blockSize: z.number().int().positive().optional(),
+    /** Max per-axis search displacement in analysis pixels. Default 8. */
+    searchRadius: z.number().int().positive().optional(),
+    /** Grid stride between block origins. Defaults to `blockSize` (non-overlapping). */
+    step: z.number().int().positive().optional(),
+    /** Minimum distinctiveness (0..1) for a vector to count toward the means. Default 0.05. */
+    minConfidence: z.number().min(0).max(1).optional()
+});
+/** A single block-motion estimate. */
+export const FlowVectorSchema = z.object({
+    /** Block origin x (analysis space). */
+    x: z.number().int().nonnegative(),
+    /** Block origin y (analysis space). */
+    y: z.number().int().nonnegative(),
+    /** Estimated horizontal displacement (analysis pixels; +right). */
+    dx: z.number().int(),
+    /** Estimated vertical displacement (analysis pixels; +down). */
+    dy: z.number().int(),
+    /** Distinctiveness of the match, 0..1 (gap between best and runner-up). */
+    confidence: z.number().min(0).max(1)
+});
+/** Result of `opticalFlow(a, b)`. */
+export const OpticalFlowResultSchema = z.object({
+    /** Per-block motion vectors over the analysis grid. */
+    vectors: z.array(FlowVectorSchema),
+    /** Confidence-weighted mean horizontal displacement. */
+    meanDx: z.number(),
+    /** Confidence-weighted mean vertical displacement. */
+    meanDy: z.number(),
+    /** Mean confidence across contributing blocks (0..1). */
+    meanConfidence: z.number().min(0).max(1),
+    /** Analysis-space width. */
+    width: z.number().int().positive(),
+    /** Analysis-space height. */
+    height: z.number().int().positive(),
+    /** Block edge length used. */
+    blockSize: z.number().int().positive()
+});
+// ── motionEnergy ─────────────────────────────────────────────────────────────
+/** A candidate motion direction (integer per-frame shift, analysis pixels). */
+export const MotionDirectionSchema = z.object({
+    dx: z.number().int(),
+    dy: z.number().int()
+});
+/** Options for `motionEnergy(frames)` (Reichardt / lag-1 cross-correlation). */
+export const MotionEnergyOptionsSchema = z.object({
+    /**
+     * Integer downscale factor. Omitted → auto-chosen so the longer edge is
+     * ≤ `maxDim`, since motion-energy is O(dirs · pixels · pairs).
+     */
+    downscale: z.number().int().positive().optional(),
+    /** Target longer-edge size (analysis pixels) when `downscale` is auto. Default 96. */
+    maxDim: z.number().int().positive().optional(),
+    /**
+     * Explicit candidate directions. Omitted → every integer shift within
+     * `shiftRadius` of the origin (excluding no-motion) is evaluated.
+     */
+    directions: z.array(MotionDirectionSchema).optional(),
+    /** Radius (analysis pixels) for auto-generated candidate directions. Default 4. */
+    shiftRadius: z.number().int().positive().optional(),
+    /** Include the per-pixel motion-energy map for the dominant direction. */
+    includeMap: z.boolean().optional()
+});
+/** Strength of coherent motion in one candidate direction. */
+export const DirectionStrengthSchema = z.object({
+    dx: z.number().int(),
+    dy: z.number().int(),
+    /** Reichardt response for this direction (opponent-subtracted, ~[-1,1]). */
+    strength: z.number()
+});
+/**
+ * Result of `motionEnergy(frames)`.
+ *
+ * `coherence` is the discriminator the passage turns on: coherently drifting
+ * structure scores high, temporally independent twinkle scores ~0, because
+ * the opponent (Reichardt) subtraction cancels non-directional correlation.
+ */
+export const MotionEnergyResultSchema = z.object({
+    /** Overall coherent-motion strength, 0..1 (max opponent response, clamped). */
+    coherence: z.number().min(0).max(1),
+    /** Direction with the strongest coherent response. */
+    dominant: DirectionStrengthSchema,
+    /** Top candidate directions by strength (descending), for inspection. */
+    perDirection: z.array(DirectionStrengthSchema),
+    /** Analysis-space width. */
+    width: z.number().int().positive(),
+    /** Analysis-space height. */
+    height: z.number().int().positive(),
+    /** Per-pixel motion-energy map for the dominant direction. Present iff `includeMap`. */
+    map: z.instanceof(Float32Array).optional()
+});
+// ── summarize ────────────────────────────────────────────────────────────────
+/** Coarse classification of what a frame sequence is doing. */
+export const MotionVerdictSchema = z.union([
+    z.literal('static'),
+    z.literal('coherent-motion'),
+    z.literal('incoherent-change')
+]);
+/** Options for `summarize(frames)`. */
+export const MotionSummaryOptionsSchema = z.object({
+    /** Integer downscale factor propagated to the underlying primitives. */
+    downscale: z.number().int().positive().optional(),
+    /** Coherence at/above which the verdict is `coherent-motion`. Default 0.35. */
+    coherenceThreshold: z.number().min(0).max(1).optional(),
+    /** Combined diff-magnitude + temporal-std below which the verdict is `static`. Default 0.01. */
+    staticThreshold: z.number().min(0).max(1).optional()
+});
+/**
+ * Compact, agent-facing summary of a frame sequence — "what happened between
+ * these samples" distilled to a payload a vision model or planner can act on.
+ */
+export const MotionSummarySchema = z.object({
+    /** Number of frames analysed. */
+    frameCount: z.number().int().min(2),
+    /** First→last change. */
+    changed: z.object({
+        magnitude: z.number().min(0).max(1),
+        changedFraction: z.number().min(0).max(1),
+        bbox: RegionSchema.nullable()
+    }),
+    /** Coherent-motion assessment. */
+    motion: z.object({
+        coherence: z.number().min(0).max(1),
+        dominant: DirectionStrengthSchema
+    }),
+    /** Temporal-variability assessment. */
+    temporal: z.object({
+        meanStd: z.number().min(0).max(1),
+        peakStd: z.number().min(0).max(1)
+    }),
+    /** Coarse classification derived from the above. */
+    verdict: MotionVerdictSchema
+});
+//# sourceMappingURL=motion-analysis.js.map

package/dist/schemas/motion-analysis.js.map

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

package/dist/schemas/motion-descriptor.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Motion Analyzer Descriptor Schema
+ *
+ * Schema for `media/motion` kind descriptors. A descriptor declares a
+ * temporal-perception provider — something that, given a sequence of decoded
+ * frames, computes what changed, what moved, and whether motion is coherent.
+ *
+ * Unlike `media/capture`, motion analysis is pure computation with no hardware
+ * dependency, so the reference provider ships inside this package. Descriptors
+ * still declare `hardware` so a heavier provider (WASM SIMD, native, GPU) can
+ * register for a specific scope and win resolution there.
+ */
+import * as z from 'zod/v4';
+/**
+ * Named primitives a motion analyzer can expose. Open enum: providers may
+ * advertise additional capabilities as string literals.
+ */
+export declare const MotionCapabilitySchema: z.ZodUnion<readonly [z.ZodLiteral<"frame-diff">, z.ZodLiteral<"temporal-stats">, z.ZodLiteral<"optical-flow">, z.ZodLiteral<"motion-energy">, z.ZodLiteral<"summarize">, z.ZodString]>;
+export type MotionCapability = z.infer<typeof MotionCapabilitySchema>;
+/**
+ * Hardware classes a motion analyzer can run against. The reference provider
+ * is pure TS and declares both `consumer` and `cloud`; a native/GPU provider
+ * would declare only the scope it accelerates.
+ */
+export declare const MotionHardwareSchema: z.ZodUnion<readonly [z.ZodLiteral<"consumer">, z.ZodLiteral<"cloud">, z.ZodString]>;
+export type MotionHardware = z.infer<typeof MotionHardwareSchema>;
+/** `media/motion` descriptor. */
+export declare const MotionAnalyzerDescriptorSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    priority: z.ZodOptional<z.ZodNumber>;
+    capabilityId: z.ZodOptional<z.ZodString>;
+    requiredContext: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    optionalContext: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    config: z.ZodOptional<z.ZodUnknown>;
+    retention: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        maxAgeDays: z.ZodOptional<z.ZodNumber>;
+        maxEntries: z.ZodOptional<z.ZodNumber>;
+        maxBytes: z.ZodOptional<z.ZodNumber>;
+        cascadeFrom: z.ZodOptional<z.ZodString>;
+        ageField: z.ZodOptional<z.ZodString>;
+        reason: z.ZodString;
+        enforcedBy: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>]>>;
+    kind: z.ZodLiteral<"media/motion">;
+    capabilities: z.ZodArray<z.ZodUnion<readonly [z.ZodLiteral<"frame-diff">, z.ZodLiteral<"temporal-stats">, z.ZodLiteral<"optical-flow">, z.ZodLiteral<"motion-energy">, z.ZodLiteral<"summarize">, z.ZodString]>>;
+    hardware: z.ZodArray<z.ZodUnion<readonly [z.ZodLiteral<"consumer">, z.ZodLiteral<"cloud">, z.ZodString]>>;
+    enabled: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+export type MotionAnalyzerDescriptor = z.infer<typeof MotionAnalyzerDescriptorSchema>;
+//# sourceMappingURL=motion-descriptor.d.ts.map

package/dist/schemas/motion-descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"motion-descriptor.d.ts","sourceRoot":"","sources":["../../src/schemas/motion-descriptor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAG5B;;;GAGG;AACH,eAAO,MAAM,sBAAsB,wLAOjC,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,qFAI/B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,iCAAiC;AACjC,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;iBAWzC,CAAC;AAEH,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC"}

package/dist/schemas/motion-descriptor.js

@@ -0,0 +1,47 @@
+/**
+ * Motion Analyzer Descriptor Schema
+ *
+ * Schema for `media/motion` kind descriptors. A descriptor declares a
+ * temporal-perception provider — something that, given a sequence of decoded
+ * frames, computes what changed, what moved, and whether motion is coherent.
+ *
+ * Unlike `media/capture`, motion analysis is pure computation with no hardware
+ * dependency, so the reference provider ships inside this package. Descriptors
+ * still declare `hardware` so a heavier provider (WASM SIMD, native, GPU) can
+ * register for a specific scope and win resolution there.
+ */
+import * as z from 'zod/v4';
+import { RuntimeDescriptorSchema } from '@vibesdotdev/kernel/schemas/descriptor';
+/**
+ * Named primitives a motion analyzer can expose. Open enum: providers may
+ * advertise additional capabilities as string literals.
+ */
+export const MotionCapabilitySchema = z.union([
+    z.literal('frame-diff'),
+    z.literal('temporal-stats'),
+    z.literal('optical-flow'),
+    z.literal('motion-energy'),
+    z.literal('summarize'),
+    z.string().min(1)
+]);
+/**
+ * Hardware classes a motion analyzer can run against. The reference provider
+ * is pure TS and declares both `consumer` and `cloud`; a native/GPU provider
+ * would declare only the scope it accelerates.
+ */
+export const MotionHardwareSchema = z.union([
+    z.literal('consumer'),
+    z.literal('cloud'),
+    z.string().min(1)
+]);
+/** `media/motion` descriptor. */
+export const MotionAnalyzerDescriptorSchema = RuntimeDescriptorSchema.extend({
+    kind: z.literal('media/motion'),
+    /** Primitives this provider implements. */
+    capabilities: z.array(MotionCapabilitySchema).min(1),
+    /** Hardware classes the provider supports (refines `RuntimeDescriptorSchema.hardware`). */
+    hardware: z.array(MotionHardwareSchema).min(1),
+    /** Whether the descriptor is currently enabled for resolution. */
+    enabled: z.boolean().default(true)
+});
+//# sourceMappingURL=motion-descriptor.js.map

package/dist/schemas/motion-descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"motion-descriptor.js","sourceRoot":"","sources":["../../src/schemas/motion-descriptor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,uBAAuB,EAAE,MAAM,wCAAwC,CAAC;AAEjF;;;GAGG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC;IAC7C,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC;IACvB,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAC;IAC3B,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC;IACzB,CAAC,CAAC,OAAO,CAAC,eAAe,CAAC;IAC1B,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC;IACtB,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CACjB,CAAC,CAAC;AAIH;;;;GAIG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC;IAC3C,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC;IACrB,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC;IAClB,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CACjB,CAAC,CAAC;AAIH,iCAAiC;AACjC,MAAM,CAAC,MAAM,8BAA8B,GAAG,uBAAuB,CAAC,MAAM,CAAC;IAC5E,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC;IAE/B,2CAA2C;IAC3C,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAEpD,2FAA2F;IAC3F,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAE9C,kEAAkE;IAClE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;CAClC,CAAC,CAAC"}

package/dist/schemas/motion-frame.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Motion Frame Schema
+ *
+ * A `Frame` is a single **decoded** raster — the unit of input for
+ * `media/motion` analysis. Motion analysis operates on a *sequence* of these
+ * (e.g. successive screenshots, or frames pulled from a clip by a decoder),
+ * not on encoded bytes: decoding/transcoding is `media/capture`'s concern,
+ * perception is this kind's.
+ *
+ * Frames carry raw pixel bytes plus geometry. Single-channel (luma) frames
+ * are analysed directly; 3-/4-channel frames are reduced to luminance
+ * (0.299R + 0.587G + 0.114B) before analysis, because human motion-energy
+ * detectors (V1/MT) are overwhelmingly luminance-driven and that is the
+ * signal the passage's coherent-drift carrier lives in.
+ */
+import * as z from 'zod/v4';
+export declare const MAX_FRAME_PIXELS = 40000000;
+/**
+ * Accepted pixel-buffer types. Canvas `ImageData` yields `Uint8ClampedArray`;
+ * native/decoder paths yield `Uint8Array`. Both are byte-addressable rasters.
+ */
+export declare const PixelBufferSchema: z.ZodUnion<readonly [z.ZodInstanceOf<Uint8Array<ArrayBuffer>>, z.ZodInstanceOf<Uint8ClampedArray<ArrayBuffer>>]>;
+export type PixelBuffer = z.infer<typeof PixelBufferSchema>;
+/**
+ * Channel layout of a frame's pixel buffer.
+ *
+ * - `1` — luma / grayscale, one byte per pixel.
+ * - `3` — packed RGB, three bytes per pixel.
+ * - `4` — packed RGBA (alpha ignored for luma), four bytes per pixel.
+ */
+export declare const FrameChannelsSchema: z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<3>, z.ZodLiteral<4>]>;
+export type FrameChannels = z.infer<typeof FrameChannelsSchema>;
+/**
+ * A single decoded frame.
+ *
+ * `data.length` must be at least `width * height * channels`. Extra trailing
+ * bytes (row padding / stride) are tolerated but not interpreted — callers
+ * with strided buffers should repack to tight rows first.
+ */
+export declare const FrameSchema: z.ZodObject<{
+    data: z.ZodUnion<readonly [z.ZodInstanceOf<Uint8Array<ArrayBuffer>>, z.ZodInstanceOf<Uint8ClampedArray<ArrayBuffer>>]>;
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+    channels: z.ZodDefault<z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<3>, z.ZodLiteral<4>]>>;
+    timestampMs: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type Frame = z.infer<typeof FrameSchema>;
+/**
+ * An ordered sequence of frames. Temporal analyses (`temporalStats`,
+ * `motionEnergy`) require at least two frames; pairwise analyses
+ * (`frameDiff`, `opticalFlow`) take exactly two.
+ */
+export declare const FrameSequenceSchema: z.ZodArray<z.ZodObject<{
+    data: z.ZodUnion<readonly [z.ZodInstanceOf<Uint8Array<ArrayBuffer>>, z.ZodInstanceOf<Uint8ClampedArray<ArrayBuffer>>]>;
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+    channels: z.ZodDefault<z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<3>, z.ZodLiteral<4>]>>;
+    timestampMs: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>>;
+export type FrameSequence = z.infer<typeof FrameSequenceSchema>;
+/** Discard schema diagnostics and thrown property access: refusals never carry rejected values. */
+export declare function parseMotionInput<const Schema extends z.ZodType>(schema: Schema, value: z.input<Schema>, options?: boolean): z.infer<Schema>;
+//# sourceMappingURL=motion-frame.d.ts.map

package/dist/schemas/motion-frame.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"motion-frame.d.ts","sourceRoot":"","sources":["../../src/schemas/motion-frame.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAI5B,eAAO,MAAM,gBAAgB,WAAa,CAAC;AAE3C;;;GAGG;AACH,eAAO,MAAM,iBAAiB,kHAG5B,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,0EAAsD,CAAC;AAEvF,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE;;;;;;GAMG;AACH,eAAO,MAAM,WAAW;;;;;;iBAsBtB,CAAC;AAEH,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEhD;;;;GAIG;AACH,eAAO,MAAM,mBAAmB;;;;;;kBAK9B,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,mGAAmG;AACnG,wBAAgB,gBAAgB,CAAC,KAAK,CAAC,MAAM,SAAS,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,UAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAKzI"}