/** * @license * Copyright 2025 Steven Roussey * SPDX-License-Identifier: Apache-2.0 */ import type { IRunConfig, TaskConfig } from "@workglow/task-graph"; import { CreateWorkflow } from "@workglow/task-graph"; import type { ImageValue } from "@workglow/util/media"; import { DataPortSchema } from "@workglow/util/schema"; import type { ModelConfig } from "../model/ModelSchema"; import { AiVisionTask } from "./base/AiVisionTask"; export declare const FaceDetectorInputSchema: { readonly type: "object"; readonly properties: { readonly image: { readonly oneOf: readonly [{ readonly type: "string"; readonly format: "image:data-uri"; }, { readonly type: "object"; readonly format: "image"; }]; readonly title: "Image"; readonly description: "Image"; readonly format: "image"; }; readonly model: { readonly oneOf: readonly [{ readonly title: "Model"; readonly description: `The model ${string}`; } & Record & { readonly format: import(".").TypeModelSemantic; readonly type: "string"; }, { readonly type: "object"; readonly properties: { readonly model_id: { readonly type: "string"; }; readonly capabilities: { readonly type: "array"; readonly items: { readonly type: "string"; }; readonly "x-ui-editor": "multiselect"; }; readonly title: { readonly type: "string"; }; readonly description: { readonly type: "string"; readonly "x-ui-editor": "textarea"; }; readonly provider: { readonly type: "string"; }; readonly provider_config: { readonly type: "object"; readonly properties: { readonly credential_key: { readonly type: "string"; readonly format: "credential"; readonly "x-ui-hidden": true; }; readonly native_dimensions: { readonly type: "integer"; readonly description: "Native output vector dimensions for embedding models"; }; readonly mrl: { readonly type: "boolean"; readonly description: "Whether the model supports Matryoshka Representation Learning"; }; }; readonly additionalProperties: true; readonly default: {}; }; readonly metadata: { readonly type: "object"; readonly default: {}; readonly "x-ui-hidden": true; }; }; readonly required: readonly ["provider", "provider_config"]; readonly format: "model"; readonly additionalProperties: true; } & Record & { readonly format: import(".").TypeModelSemantic; }]; } & Record & { readonly format: import(".").TypeModelSemantic; }; readonly minDetectionConfidence: { readonly type: "number"; readonly minimum: 0; readonly maximum: 1; readonly default: 0.5; readonly title: "Min Detection Confidence"; readonly description: "Minimum confidence score for face detection"; readonly "x-ui-group": "Configuration"; }; readonly minSuppressionThreshold: { readonly type: "number"; readonly minimum: 0; readonly maximum: 1; readonly default: 0.3; readonly title: "Min Suppression Threshold"; readonly description: "Minimum non-maximum-suppression threshold for overlapping detections"; readonly "x-ui-group": "Configuration"; }; }; readonly required: readonly ["image", "model"]; readonly additionalProperties: false; }; export declare const FaceDetectorOutputSchema: { readonly type: "object"; readonly properties: { readonly faces: { readonly oneOf: readonly [{ readonly type: "array"; readonly items: { readonly type: "object"; readonly properties: { readonly box: { readonly type: "object"; readonly properties: { readonly x: { readonly type: "number"; readonly title: "X Coordinate"; readonly description: "X coordinate of the top-left corner"; }; readonly y: { readonly type: "number"; readonly title: "Y Coordinate"; readonly description: "Y coordinate of the top-left corner"; }; readonly width: { readonly type: "number"; readonly title: "Width"; readonly description: "Width of the bounding box"; }; readonly height: { readonly type: "number"; readonly title: "Height"; readonly description: "Height of the bounding box"; }; }; readonly required: readonly ["x", "y", "width", "height"]; readonly additionalProperties: false; }; readonly keypoints: { readonly type: "array"; readonly items: { readonly type: "object"; readonly properties: { readonly x: { readonly type: "number"; readonly title: "X Coordinate"; readonly description: "X coordinate normalized to [0.0, 1.0]"; }; readonly y: { readonly type: "number"; readonly title: "Y Coordinate"; readonly description: "Y coordinate normalized to [0.0, 1.0]"; }; readonly label: { readonly type: "string"; readonly title: "Keypoint Label"; readonly description: "Label for the keypoint (e.g., 'leftEye', 'rightEye', 'noseTip', etc.)"; }; }; readonly required: readonly ["x", "y"]; readonly additionalProperties: false; }; readonly title: "Keypoints"; readonly description: "Facial keypoints (left eye, right eye, nose tip, mouth, left/right tragion)"; }; readonly score: { readonly type: "number"; readonly title: "Confidence Score"; readonly description: "Confidence score for the face detection"; }; }; readonly required: readonly ["box", "keypoints", "score"]; readonly additionalProperties: false; }; }, { readonly type: "array"; readonly items: { readonly type: "array"; readonly items: { readonly type: "object"; readonly properties: { readonly box: { readonly type: "object"; readonly properties: { readonly x: { readonly type: "number"; readonly title: "X Coordinate"; readonly description: "X coordinate of the top-left corner"; }; readonly y: { readonly type: "number"; readonly title: "Y Coordinate"; readonly description: "Y coordinate of the top-left corner"; }; readonly width: { readonly type: "number"; readonly title: "Width"; readonly description: "Width of the bounding box"; }; readonly height: { readonly type: "number"; readonly title: "Height"; readonly description: "Height of the bounding box"; }; }; readonly required: readonly ["x", "y", "width", "height"]; readonly additionalProperties: false; }; readonly keypoints: { readonly type: "array"; readonly items: { readonly type: "object"; readonly properties: { readonly x: { readonly type: "number"; readonly title: "X Coordinate"; readonly description: "X coordinate normalized to [0.0, 1.0]"; }; readonly y: { readonly type: "number"; readonly title: "Y Coordinate"; readonly description: "Y coordinate normalized to [0.0, 1.0]"; }; readonly label: { readonly type: "string"; readonly title: "Keypoint Label"; readonly description: "Label for the keypoint (e.g., 'leftEye', 'rightEye', 'noseTip', etc.)"; }; }; readonly required: readonly ["x", "y"]; readonly additionalProperties: false; }; readonly title: "Keypoints"; readonly description: "Facial keypoints (left eye, right eye, nose tip, mouth, left/right tragion)"; }; readonly score: { readonly type: "number"; readonly title: "Confidence Score"; readonly description: "Confidence score for the face detection"; }; }; readonly required: readonly ["box", "keypoints", "score"]; readonly additionalProperties: false; }; }; }]; readonly title: "Face Detections"; readonly description: "Detected faces with bounding boxes, keypoints, and confidence scores"; }; }; readonly required: readonly ["faces"]; readonly additionalProperties: false; }; export type FaceDetectorTaskInput = Omit<{ minDetectionConfidence?: number | undefined; minSuppressionThreshold?: number | undefined; model: string | ModelConfig; image: string | { [x: string]: unknown; }; }, "image"> & { image: ImageValue; }; export type FaceDetectorTaskOutput = { faces: { score: number; box: { x: number; y: number; width: number; height: number; }; keypoints: { label?: string | undefined; x: number; y: number; }[]; }[] | { score: number; box: { x: number; y: number; width: number; height: number; }; keypoints: { label?: string | undefined; x: number; y: number; }[]; }[][]; }; export type FaceDetectorTaskConfig = TaskConfig; /** * Detects faces in images using MediaPipe Face Detector. * Locates faces and identifies facial keypoints like eyes, nose, and mouth. */ export declare class FaceDetectorTask extends AiVisionTask { static type: string; /** Capabilities required of the model; gated in {@link AiTask.execute}. */ static readonly requires: ["vision.face-detection"]; static category: string; static title: string; static description: string; static inputSchema(): DataPortSchema; static outputSchema(): DataPortSchema; } export declare const faceDetector: (input: FaceDetectorTaskInput, config?: FaceDetectorTaskConfig, runConfig?: Partial) => Promise; declare module "@workglow/task-graph" { interface Workflow { faceDetector: CreateWorkflow; } } //# sourceMappingURL=FaceDetectorTask.d.ts.map