@framers/agentos 0.1.164 → 0.1.166

package/dist/media/avatar/AvatarPipeline.js.map

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

package/dist/media/avatar/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @file index.ts
+ * Barrel export for the avatar generation pipeline.
+ */
+export { AvatarPipeline, type ImageGeneratorFn } from './AvatarPipeline.js';
+export type { AvatarGenerationStage, AvatarGenerationRequest, AvatarGenerationJob, DriftAuditReport, AvatarGenerationResult, } from './types.js';
+export { AVATAR_EMOTIONS, type AvatarEmotion, buildPortraitPrompt, buildExpressionPrompt, buildEmotePrompt, } from './prompts.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/media/avatar/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/media/avatar/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,cAAc,EAAE,KAAK,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAE5E,YAAY,EACV,qBAAqB,EACrB,uBAAuB,EACvB,mBAAmB,EACnB,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,eAAe,EACf,KAAK,aAAa,EAClB,mBAAmB,EACnB,qBAAqB,EACrB,gBAAgB,GACjB,MAAM,cAAc,CAAC"}

package/dist/media/avatar/index.js

@@ -0,0 +1,7 @@
+/**
+ * @file index.ts
+ * Barrel export for the avatar generation pipeline.
+ */
+export { AvatarPipeline } from './AvatarPipeline.js';
+export { AVATAR_EMOTIONS, buildPortraitPrompt, buildExpressionPrompt, buildEmotePrompt, } from './prompts.js';
+//# sourceMappingURL=index.js.map

package/dist/media/avatar/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/media/avatar/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,cAAc,EAAyB,MAAM,qBAAqB,CAAC;AAU5E,OAAO,EACL,eAAe,EAEf,mBAAmB,EACnB,qBAAqB,EACrB,gBAAgB,GACjB,MAAM,cAAc,CAAC"}

package/dist/media/avatar/prompts.d.ts

@@ -0,0 +1,48 @@
+/**
+ * @file prompts.ts
+ * Prompt construction utilities for avatar image generation.
+ *
+ * Builds deterministic text prompts from {@link AvatarIdentityDescriptor}
+ * fields, producing consistent character depictions across emotion variants,
+ * emote animations, and full-body shots.
+ */
+import type { AvatarIdentityDescriptor } from '../../api/types.js';
+/**
+ * Canonical set of emotions for expression sheets and animated emotes.
+ * The first entry is always "neutral" — it doubles as the anchor portrait.
+ */
+export declare const AVATAR_EMOTIONS: readonly ["neutral", "happy", "sad", "angry", "surprised", "flirty", "fearful"];
+/** Union type of supported avatar emotions. */
+export type AvatarEmotion = (typeof AVATAR_EMOTIONS)[number];
+/**
+ * Concatenate all identity descriptor fields into a portrait prompt.
+ *
+ * Produces a detailed, comma-separated description suitable for
+ * text-to-image models. Omits undefined optional fields.
+ *
+ * @param identity - Character identity descriptors.
+ * @returns Prompt string for a neutral portrait.
+ */
+export declare function buildPortraitPrompt(identity: AvatarIdentityDescriptor): string;
+/**
+ * Build a prompt for a specific emotion expression of the character.
+ *
+ * Appends the emotion keyword to the base portrait prompt so the model
+ * generates the same face with the requested expression.
+ *
+ * @param identity - Character identity descriptors.
+ * @param emotion - Target emotion expression.
+ * @returns Prompt string for an emotion-specific portrait.
+ */
+export declare function buildExpressionPrompt(identity: AvatarIdentityDescriptor, emotion: AvatarEmotion | string): string;
+/**
+ * Build a prompt for an animated emote loop of a given emotion.
+ *
+ * Produces a concise prompt targeting short animation generation models
+ * (e.g. Stable Video Diffusion, AnimateDiff).
+ *
+ * @param emotion - The emotion to animate.
+ * @returns Prompt string for an animated emote.
+ */
+export declare function buildEmotePrompt(emotion: AvatarEmotion | string): string;
+//# sourceMappingURL=prompts.d.ts.map

package/dist/media/avatar/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../../src/media/avatar/prompts.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAMnE;;;GAGG;AACH,eAAO,MAAM,eAAe,iFAQlB,CAAC;AAEX,+CAA+C;AAC/C,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAM7D;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,wBAAwB,GAAG,MAAM,CA6B9E;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,wBAAwB,EAClC,OAAO,EAAE,aAAa,GAAG,MAAM,GAC9B,MAAM,CAMR;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,GAAG,MAAM,CAExE"}

package/dist/media/avatar/prompts.js

@@ -0,0 +1,88 @@
+/**
+ * @file prompts.ts
+ * Prompt construction utilities for avatar image generation.
+ *
+ * Builds deterministic text prompts from {@link AvatarIdentityDescriptor}
+ * fields, producing consistent character depictions across emotion variants,
+ * emote animations, and full-body shots.
+ */
+// ---------------------------------------------------------------------------
+// Emotion catalogue
+// ---------------------------------------------------------------------------
+/**
+ * Canonical set of emotions for expression sheets and animated emotes.
+ * The first entry is always "neutral" — it doubles as the anchor portrait.
+ */
+export const AVATAR_EMOTIONS = [
+    'neutral',
+    'happy',
+    'sad',
+    'angry',
+    'surprised',
+    'flirty',
+    'fearful',
+];
+// ---------------------------------------------------------------------------
+// Prompt builders
+// ---------------------------------------------------------------------------
+/**
+ * Concatenate all identity descriptor fields into a portrait prompt.
+ *
+ * Produces a detailed, comma-separated description suitable for
+ * text-to-image models. Omits undefined optional fields.
+ *
+ * @param identity - Character identity descriptors.
+ * @returns Prompt string for a neutral portrait.
+ */
+export function buildPortraitPrompt(identity) {
+    const parts = [];
+    parts.push(`portrait of ${identity.displayName}`);
+    parts.push(`${identity.ageBand.replace(/_/g, ' ')} age`);
+    if (identity.bodyType) {
+        parts.push(`${identity.bodyType} build`);
+    }
+    parts.push(identity.faceDescriptor);
+    if (identity.hairDescriptor) {
+        parts.push(identity.hairDescriptor);
+    }
+    if (identity.skinDescriptor) {
+        parts.push(identity.skinDescriptor);
+    }
+    if (identity.distinguishingFeatures) {
+        parts.push(identity.distinguishingFeatures);
+    }
+    if (identity.styleNotes) {
+        parts.push(identity.styleNotes);
+    }
+    return parts.join(', ');
+}
+/**
+ * Build a prompt for a specific emotion expression of the character.
+ *
+ * Appends the emotion keyword to the base portrait prompt so the model
+ * generates the same face with the requested expression.
+ *
+ * @param identity - Character identity descriptors.
+ * @param emotion - Target emotion expression.
+ * @returns Prompt string for an emotion-specific portrait.
+ */
+export function buildExpressionPrompt(identity, emotion) {
+    const base = buildPortraitPrompt(identity);
+    if (emotion === 'neutral') {
+        return base;
+    }
+    return `${base}, ${emotion} expression`;
+}
+/**
+ * Build a prompt for an animated emote loop of a given emotion.
+ *
+ * Produces a concise prompt targeting short animation generation models
+ * (e.g. Stable Video Diffusion, AnimateDiff).
+ *
+ * @param emotion - The emotion to animate.
+ * @returns Prompt string for an animated emote.
+ */
+export function buildEmotePrompt(emotion) {
+    return `animated emote loop, ${emotion} expression, character portrait, seamless loop`;
+}
+//# sourceMappingURL=prompts.js.map

package/dist/media/avatar/prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../../../src/media/avatar/prompts.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,8EAA8E;AAC9E,oBAAoB;AACpB,8EAA8E;AAE9E;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,SAAS;IACT,OAAO;IACP,KAAK;IACL,OAAO;IACP,WAAW;IACX,QAAQ;IACR,SAAS;CACD,CAAC;AAKX,8EAA8E;AAC9E,kBAAkB;AAClB,8EAA8E;AAE9E;;;;;;;;GAQG;AACH,MAAM,UAAU,mBAAmB,CAAC,QAAkC;IACpE,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,CAAC,IAAI,CAAC,eAAe,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC;IAClD,KAAK,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAEzD,IAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC;QACtB,KAAK,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,QAAQ,QAAQ,CAAC,CAAC;IAC3C,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;IAEpC,IAAI,QAAQ,CAAC,cAAc,EAAE,CAAC;QAC5B,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;IACtC,CAAC;IAED,IAAI,QAAQ,CAAC,cAAc,EAAE,CAAC;QAC5B,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;IACtC,CAAC;IAED,IAAI,QAAQ,CAAC,sBAAsB,EAAE,CAAC;QACpC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,sBAAsB,CAAC,CAAC;IAC9C,CAAC;IAED,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC;QACxB,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;IAClC,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,qBAAqB,CACnC,QAAkC,EAClC,OAA+B;IAE/B,MAAM,IAAI,GAAG,mBAAmB,CAAC,QAAQ,CAAC,CAAC;IAC3C,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,GAAG,IAAI,KAAK,OAAO,aAAa,CAAC;AAC1C,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAA+B;IAC9D,OAAO,wBAAwB,OAAO,gDAAgD,CAAC;AACzF,CAAC"}

package/dist/media/avatar/types.d.ts

@@ -0,0 +1,101 @@
+/**
+ * @file types.ts
+ * Type definitions for the avatar generation pipeline.
+ *
+ * Covers the full lifecycle: request → staged jobs → drift audit → result.
+ */
+import type { AvatarIdentityDescriptor, AvatarIdentityPackage } from '../../api/types.js';
+import type { PolicyTier } from '../../core/llm/routing/UncensoredModelCatalog.js';
+/**
+ * Discrete stages of the avatar generation pipeline, executed in order.
+ *
+ * - `neutral_portrait` — Generate the canonical neutral-expression portrait.
+ * - `face_embedding` — Extract a 512-dim face vector from the neutral portrait.
+ * - `expression_sheet` — Generate emotion variants and drift-check each one.
+ * - `animated_emotes` — Generate animated emote loops per emotion.
+ * - `full_body` — Generate a full-body reference image.
+ * - `additional_angles` — Generate extra viewpoint references (3/4, profile).
+ */
+export type AvatarGenerationStage = 'neutral_portrait' | 'face_embedding' | 'expression_sheet' | 'animated_emotes' | 'full_body' | 'additional_angles';
+/** Input to the avatar generation pipeline. */
+export interface AvatarGenerationRequest {
+    /** Character identifier for the generated identity package. */
+    characterId: string;
+    /** Identity descriptors driving image generation prompts. */
+    identity: AvatarIdentityDescriptor;
+    /** Which stages to execute (defaults to all). */
+    stages?: AvatarGenerationStage[];
+    /** Content policy tier forwarded to the image generator. */
+    policyTier?: PolicyTier;
+    /** Image generation parameters. */
+    generationConfig: {
+        /** Model identifier (e.g. "black-forest-labs/flux-schnell"). */
+        baseModel: string;
+        /** Provider identifier (e.g. "replicate"). */
+        provider: string;
+        /** Random seed for reproducible output. */
+        seed?: number;
+        /** Negative prompt to avoid unwanted artefacts. */
+        negativePrompt?: string;
+        /** Named style preset (provider-specific). */
+        stylePreset?: string;
+    };
+    /** Drift-guard thresholds. */
+    driftGuard?: {
+        /** Minimum cosine similarity to the anchor face embedding. */
+        faceSimilarity?: number;
+        /** Reject images below the similarity threshold. */
+        rejectBelowThreshold?: boolean;
+        /** Maximum retries when generated face drifts. */
+        maxRegenerationAttempts?: number;
+    };
+    /** Pre-existing anchors to reuse instead of regenerating. */
+    existingAnchors?: {
+        neutralPortrait?: string;
+        faceEmbedding?: number[];
+    };
+}
+/** Tracking record for a single pipeline job. */
+export interface AvatarGenerationJob {
+    /** Which stage this job belongs to. */
+    stage: AvatarGenerationStage;
+    /** Human-readable label (e.g. "neutral_portrait", "expression:happy"). */
+    label: string;
+    /** Job status. */
+    status: 'pending' | 'running' | 'completed' | 'failed' | 'skipped';
+    /** Generated image URL on success. */
+    imageUrl?: string;
+    /** Drift similarity score (for expression/emote stages). */
+    driftScore?: number;
+    /** Number of regeneration attempts for this job. */
+    attempts: number;
+    /** Error message on failure. */
+    error?: string;
+    /** Wall-clock duration in milliseconds. */
+    durationMs?: number;
+}
+/** Aggregate drift audit across all generated assets. */
+export interface DriftAuditReport {
+    /** Anchor face embedding used as the reference. */
+    anchorEmbeddingDim: number;
+    /** Per-image drift scores keyed by label. */
+    scores: Record<string, number>;
+    /** Labels of images that were rejected for excessive drift. */
+    rejected: string[];
+    /** Labels of images that were regenerated (at least once). */
+    regenerated: string[];
+    /** Overall pass/fail for the entire batch. */
+    passed: boolean;
+}
+/** Output of a complete avatar generation pipeline run. */
+export interface AvatarGenerationResult {
+    /** The assembled identity package. */
+    identityPackage: AvatarIdentityPackage;
+    /** Per-stage job records for observability. */
+    jobs: AvatarGenerationJob[];
+    /** Drift audit report (present when face_embedding stage ran). */
+    driftReport?: DriftAuditReport;
+    /** Total wall-clock time in milliseconds. */
+    totalDurationMs: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/media/avatar/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/media/avatar/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,wBAAwB,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC1F,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kDAAkD,CAAC;AAMnF;;;;;;;;;GASG;AACH,MAAM,MAAM,qBAAqB,GAC7B,kBAAkB,GAClB,gBAAgB,GAChB,kBAAkB,GAClB,iBAAiB,GACjB,WAAW,GACX,mBAAmB,CAAC;AAMxB,+CAA+C;AAC/C,MAAM,WAAW,uBAAuB;IACtC,+DAA+D;IAC/D,WAAW,EAAE,MAAM,CAAC;IACpB,6DAA6D;IAC7D,QAAQ,EAAE,wBAAwB,CAAC;IACnC,iDAAiD;IACjD,MAAM,CAAC,EAAE,qBAAqB,EAAE,CAAC;IACjC,4DAA4D;IAC5D,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,mCAAmC;IACnC,gBAAgB,EAAE;QAChB,gEAAgE;QAChE,SAAS,EAAE,MAAM,CAAC;QAClB,8CAA8C;QAC9C,QAAQ,EAAE,MAAM,CAAC;QACjB,2CAA2C;QAC3C,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,mDAAmD;QACnD,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,8CAA8C;QAC9C,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,8BAA8B;IAC9B,UAAU,CAAC,EAAE;QACX,8DAA8D;QAC9D,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,oDAAoD;QACpD,oBAAoB,CAAC,EAAE,OAAO,CAAC;QAC/B,kDAAkD;QAClD,uBAAuB,CAAC,EAAE,MAAM,CAAC;KAClC,CAAC;IACF,6DAA6D;IAC7D,eAAe,CAAC,EAAE;QAChB,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;KAC1B,CAAC;CACH;AAED,iDAAiD;AACjD,MAAM,WAAW,mBAAmB;IAClC,uCAAuC;IACvC,KAAK,EAAE,qBAAqB,CAAC;IAC7B,0EAA0E;IAC1E,KAAK,EAAE,MAAM,CAAC;IACd,kBAAkB;IAClB,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;IACnE,sCAAsC;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4DAA4D;IAC5D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oDAAoD;IACpD,QAAQ,EAAE,MAAM,CAAC;IACjB,gCAAgC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2CAA2C;IAC3C,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,yDAAyD;AACzD,MAAM,WAAW,gBAAgB;IAC/B,mDAAmD;IACnD,kBAAkB,EAAE,MAAM,CAAC;IAC3B,6CAA6C;IAC7C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,+DAA+D;IAC/D,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,8DAA8D;IAC9D,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,8CAA8C;IAC9C,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,2DAA2D;AAC3D,MAAM,WAAW,sBAAsB;IACrC,sCAAsC;IACtC,eAAe,EAAE,qBAAqB,CAAC;IACvC,+CAA+C;IAC/C,IAAI,EAAE,mBAAmB,EAAE,CAAC;IAC5B,kEAAkE;IAClE,WAAW,CAAC,EAAE,gBAAgB,CAAC;IAC/B,6CAA6C;IAC7C,eAAe,EAAE,MAAM,CAAC;CACzB"}

package/dist/media/avatar/types.js

@@ -0,0 +1,8 @@
+/**
+ * @file types.ts
+ * Type definitions for the avatar generation pipeline.
+ *
+ * Covers the full lifecycle: request → staged jobs → drift audit → result.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/media/avatar/types.js.map

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

package/dist/media/images/face/IFaceEmbeddingService.d.ts

@@ -0,0 +1,69 @@
+/**
+ * @file IFaceEmbeddingService.ts
+ * Interface for face embedding extraction and comparison services.
+ *
+ * Provides a provider-agnostic contract for extracting facial feature vectors
+ * from images and computing similarity between two face embeddings.
+ */
+/** Bounding box coordinates for a detected face within an image. */
+export interface FaceBoundingBox {
+    /** X-coordinate of the top-left corner. */
+    x: number;
+    /** Y-coordinate of the top-left corner. */
+    y: number;
+    /** Width of the bounding box in pixels. */
+    width: number;
+    /** Height of the bounding box in pixels. */
+    height: number;
+}
+/** Face embedding vector with optional detection metadata. */
+export interface FaceEmbedding {
+    /** High-dimensional vector representing facial features. */
+    vector: number[];
+    /** Bounding box of the detected face in the source image. */
+    boundingBox?: FaceBoundingBox;
+    /** Detection confidence score in [0, 1]. */
+    confidence?: number;
+}
+/** Result of comparing two face embeddings. */
+export interface FaceComparisonResult {
+    /** Cosine similarity score in [-1, 1]. */
+    similarity: number;
+    /** Whether the two faces belong to the same identity (above threshold). */
+    match: boolean;
+}
+/**
+ * Provider-agnostic service for extracting face embeddings from images
+ * and comparing them for identity consistency.
+ */
+export interface IFaceEmbeddingService {
+    /**
+     * Extract a face embedding vector from an image URL or data URI.
+     *
+     * @param imageUrl - Public URL or base64 data URI of the image.
+     * @returns The extracted face embedding.
+     */
+    extractEmbedding(imageUrl: string): Promise<FaceEmbedding>;
+    /**
+     * Compare two face embeddings and return a similarity score.
+     *
+     * @param a - First face embedding vector.
+     * @param b - Second face embedding vector.
+     * @param threshold - Minimum similarity to consider a match (default 0.6).
+     * @returns Comparison result with similarity and match flag.
+     */
+    compareFaces(a: number[], b: number[], threshold?: number): FaceComparisonResult;
+}
+/**
+ * Compute the cosine similarity between two equal-length numeric vectors.
+ *
+ * Returns a value in [-1, 1] where 1 means identical direction, 0 means
+ * orthogonal, and -1 means opposite direction. Returns 0 for zero-magnitude
+ * vectors to avoid division-by-zero.
+ *
+ * @param a - First vector.
+ * @param b - Second vector.
+ * @returns Cosine similarity score.
+ */
+export declare function cosineSimilarity(a: number[], b: number[]): number;
+//# sourceMappingURL=IFaceEmbeddingService.d.ts.map

package/dist/media/images/face/IFaceEmbeddingService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IFaceEmbeddingService.d.ts","sourceRoot":"","sources":["../../../../src/media/images/face/IFaceEmbeddingService.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,oEAAoE;AACpE,MAAM,WAAW,eAAe;IAC9B,2CAA2C;IAC3C,CAAC,EAAE,MAAM,CAAC;IACV,2CAA2C;IAC3C,CAAC,EAAE,MAAM,CAAC;IACV,2CAA2C;IAC3C,KAAK,EAAE,MAAM,CAAC;IACd,4CAA4C;IAC5C,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,8DAA8D;AAC9D,MAAM,WAAW,aAAa;IAC5B,4DAA4D;IAC5D,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,6DAA6D;IAC7D,WAAW,CAAC,EAAE,eAAe,CAAC;IAC9B,4CAA4C;IAC5C,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,+CAA+C;AAC/C,MAAM,WAAW,oBAAoB;IACnC,0CAA0C;IAC1C,UAAU,EAAE,MAAM,CAAC;IACnB,2EAA2E;IAC3E,KAAK,EAAE,OAAO,CAAC;CAChB;AAMD;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;;;OAKG;IACH,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAE3D;;;;;;;OAOG;IACH,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,oBAAoB,CAAC;CAClF;AAMD;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CAqBjE"}

package/dist/media/images/face/IFaceEmbeddingService.js

@@ -0,0 +1,40 @@
+/**
+ * @file IFaceEmbeddingService.ts
+ * Interface for face embedding extraction and comparison services.
+ *
+ * Provides a provider-agnostic contract for extracting facial feature vectors
+ * from images and computing similarity between two face embeddings.
+ */
+// ---------------------------------------------------------------------------
+// Cosine similarity
+// ---------------------------------------------------------------------------
+/**
+ * Compute the cosine similarity between two equal-length numeric vectors.
+ *
+ * Returns a value in [-1, 1] where 1 means identical direction, 0 means
+ * orthogonal, and -1 means opposite direction. Returns 0 for zero-magnitude
+ * vectors to avoid division-by-zero.
+ *
+ * @param a - First vector.
+ * @param b - Second vector.
+ * @returns Cosine similarity score.
+ */
+export function cosineSimilarity(a, b) {
+    if (a.length !== b.length) {
+        throw new Error(`Vector dimension mismatch: ${a.length} vs ${b.length}`);
+    }
+    let dotProduct = 0;
+    let magnitudeA = 0;
+    let magnitudeB = 0;
+    for (let i = 0; i < a.length; i++) {
+        dotProduct += a[i] * b[i];
+        magnitudeA += a[i] * a[i];
+        magnitudeB += b[i] * b[i];
+    }
+    const denominator = Math.sqrt(magnitudeA) * Math.sqrt(magnitudeB);
+    if (denominator === 0) {
+        return 0;
+    }
+    return dotProduct / denominator;
+}
+//# sourceMappingURL=IFaceEmbeddingService.js.map

package/dist/media/images/face/IFaceEmbeddingService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IFaceEmbeddingService.js","sourceRoot":"","sources":["../../../../src/media/images/face/IFaceEmbeddingService.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAgEH,8EAA8E;AAC9E,oBAAoB;AACpB,8EAA8E;AAE9E;;;;;;;;;;GAUG;AACH,MAAM,UAAU,gBAAgB,CAAC,CAAW,EAAE,CAAW;IACvD,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC,MAAM,OAAO,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;IAC3E,CAAC;IAED,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,IAAI,UAAU,GAAG,CAAC,CAAC;IAEnB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAClC,UAAU,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAC1B,UAAU,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAC1B,UAAU,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5B,CAAC;IAED,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAClE,IAAI,WAAW,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,CAAC,CAAC;IACX,CAAC;IAED,OAAO,UAAU,GAAG,WAAW,CAAC;AAClC,CAAC"}

package/dist/media/images/face/ReplicateFaceEmbeddingService.d.ts

@@ -0,0 +1,57 @@
+/**
+ * @file ReplicateFaceEmbeddingService.ts
+ * Replicate-backed face embedding extraction using InsightFace.
+ *
+ * Posts image URLs to the Replicate predictions API, polls for completion,
+ * and returns 512-dimensional face embedding vectors for drift detection.
+ */
+import { type FaceComparisonResult, type FaceEmbedding, type IFaceEmbeddingService } from './IFaceEmbeddingService.js';
+/** Constructor options for {@link ReplicateFaceEmbeddingService}. */
+export interface ReplicateFaceEmbeddingConfig {
+    /** Replicate API token. */
+    apiKey: string;
+    /** Override the Replicate API base URL (default: https://api.replicate.com/v1). */
+    baseUrl?: string;
+    /** Override the InsightFace model version identifier. */
+    modelId?: string;
+}
+/**
+ * Extracts face embeddings via the Replicate API using InsightFace.
+ *
+ * Sends a prediction request with the provided image URL, polls until the
+ * prediction completes, then parses the embedding vector from the response.
+ */
+export declare class ReplicateFaceEmbeddingService implements IFaceEmbeddingService {
+    private readonly apiKey;
+    private readonly baseUrl;
+    private readonly modelId;
+    constructor(config: ReplicateFaceEmbeddingConfig);
+    /**
+     * Extract a face embedding from an image.
+     *
+     * @param imageUrl - Public URL or base64 data URI of the image.
+     * @returns Face embedding with 512-dim vector and optional bounding box.
+     */
+    extractEmbedding(imageUrl: string): Promise<FaceEmbedding>;
+    /**
+     * Compare two face embedding vectors using cosine similarity.
+     *
+     * @param a - First embedding vector.
+     * @param b - Second embedding vector.
+     * @param threshold - Minimum similarity to consider a match (default 0.6).
+     * @returns Comparison result with similarity score and match flag.
+     */
+    compareFaces(a: number[], b: number[], threshold?: number): FaceComparisonResult;
+    /**
+     * Poll a Replicate prediction URL until it reaches a terminal state.
+     */
+    private pollPrediction;
+    /**
+     * Parse the Replicate InsightFace output into a {@link FaceEmbedding}.
+     *
+     * InsightFace returns an array of detected faces. Each face object contains
+     * an `embedding` array and optionally a `bbox` array [x1, y1, x2, y2].
+     */
+    private parseEmbeddingOutput;
+}
+//# sourceMappingURL=ReplicateFaceEmbeddingService.d.ts.map

package/dist/media/images/face/ReplicateFaceEmbeddingService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReplicateFaceEmbeddingService.d.ts","sourceRoot":"","sources":["../../../../src/media/images/face/ReplicateFaceEmbeddingService.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAEL,KAAK,oBAAoB,EACzB,KAAK,aAAa,EAClB,KAAK,qBAAqB,EAC3B,MAAM,4BAA4B,CAAC;AAMpC,qEAAqE;AACrE,MAAM,WAAW,4BAA4B;IAC3C,2BAA2B;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,mFAAmF;IACnF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yDAAyD;IACzD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AA2BD;;;;;GAKG;AACH,qBAAa,6BAA8B,YAAW,qBAAqB;IACzE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,MAAM,EAAE,4BAA4B;IAShD;;;;;OAKG;IACG,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IA8ChE;;;;;;;OAOG;IACH,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,SAAS,SAAM,GAAG,oBAAoB;IAY7E;;OAEG;YACW,cAAc;IAwB5B;;;;;OAKG;IACH,OAAO,CAAC,oBAAoB;CAoC7B"}

package/dist/media/images/face/ReplicateFaceEmbeddingService.js

@@ -0,0 +1,151 @@
+/**
+ * @file ReplicateFaceEmbeddingService.ts
+ * Replicate-backed face embedding extraction using InsightFace.
+ *
+ * Posts image URLs to the Replicate predictions API, polls for completion,
+ * and returns 512-dimensional face embedding vectors for drift detection.
+ */
+import { cosineSimilarity, } from './IFaceEmbeddingService.js';
+const DEFAULT_BASE_URL = 'https://api.replicate.com/v1';
+const DEFAULT_MODEL_ID = 'daanelson/insightface:da3ed9bc348e12dfe81e7cb3adcdee5a2ce23e2e854ec45e4109990f5132653b';
+const POLL_INTERVAL_MS = 1500;
+const POLL_TIMEOUT_MS = 120000;
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+// ---------------------------------------------------------------------------
+// Service
+// ---------------------------------------------------------------------------
+/**
+ * Extracts face embeddings via the Replicate API using InsightFace.
+ *
+ * Sends a prediction request with the provided image URL, polls until the
+ * prediction completes, then parses the embedding vector from the response.
+ */
+export class ReplicateFaceEmbeddingService {
+    constructor(config) {
+        if (!config.apiKey) {
+            throw new Error('ReplicateFaceEmbeddingService requires an apiKey.');
+        }
+        this.apiKey = config.apiKey;
+        this.baseUrl = config.baseUrl?.replace(/\/+$/, '') ?? DEFAULT_BASE_URL;
+        this.modelId = config.modelId ?? DEFAULT_MODEL_ID;
+    }
+    /**
+     * Extract a face embedding from an image.
+     *
+     * @param imageUrl - Public URL or base64 data URI of the image.
+     * @returns Face embedding with 512-dim vector and optional bounding box.
+     */
+    async extractEmbedding(imageUrl) {
+        const body = {
+            version: this.modelId,
+            input: {
+                image: imageUrl,
+                return_embedding: true,
+            },
+        };
+        // Create prediction
+        const createResponse = await fetch(`${this.baseUrl}/predictions`, {
+            method: 'POST',
+            headers: {
+                Authorization: `Token ${this.apiKey}`,
+                'Content-Type': 'application/json',
+                Prefer: 'wait=60',
+            },
+            body: JSON.stringify(body),
+        });
+        if (!createResponse.ok) {
+            const errorText = await createResponse.text();
+            throw new Error(`Replicate face embedding request failed (${createResponse.status}): ${errorText}`);
+        }
+        let prediction = (await createResponse.json());
+        // Poll for completion if not immediately resolved
+        if (prediction.status &&
+            !['succeeded', 'failed', 'canceled'].includes(prediction.status) &&
+            prediction.urls?.get) {
+            prediction = await this.pollPrediction(prediction.urls.get);
+        }
+        if (prediction.status === 'failed') {
+            throw new Error(`Face embedding extraction failed: ${prediction.error ?? 'unknown error'}`);
+        }
+        if (prediction.status === 'canceled') {
+            throw new Error('Face embedding extraction was canceled.');
+        }
+        return this.parseEmbeddingOutput(prediction.output);
+    }
+    /**
+     * Compare two face embedding vectors using cosine similarity.
+     *
+     * @param a - First embedding vector.
+     * @param b - Second embedding vector.
+     * @param threshold - Minimum similarity to consider a match (default 0.6).
+     * @returns Comparison result with similarity score and match flag.
+     */
+    compareFaces(a, b, threshold = 0.6) {
+        const similarity = cosineSimilarity(a, b);
+        return {
+            similarity,
+            match: similarity >= threshold,
+        };
+    }
+    // -------------------------------------------------------------------------
+    // Private helpers
+    // -------------------------------------------------------------------------
+    /**
+     * Poll a Replicate prediction URL until it reaches a terminal state.
+     */
+    async pollPrediction(url) {
+        const startedAt = Date.now();
+        while (Date.now() - startedAt < POLL_TIMEOUT_MS) {
+            const response = await fetch(url, {
+                headers: { Authorization: `Token ${this.apiKey}` },
+            });
+            if (!response.ok) {
+                const errorText = await response.text();
+                throw new Error(`Replicate prediction polling failed (${response.status}): ${errorText}`);
+            }
+            const prediction = (await response.json());
+            if (!prediction.status || ['succeeded', 'failed', 'canceled'].includes(prediction.status)) {
+                return prediction;
+            }
+            await sleep(POLL_INTERVAL_MS);
+        }
+        throw new Error('Face embedding extraction timed out while waiting for prediction.');
+    }
+    /**
+     * Parse the Replicate InsightFace output into a {@link FaceEmbedding}.
+     *
+     * InsightFace returns an array of detected faces. Each face object contains
+     * an `embedding` array and optionally a `bbox` array [x1, y1, x2, y2].
+     */
+    parseEmbeddingOutput(output) {
+        // The output is typically an array of face objects
+        const faces = Array.isArray(output) ? output : [output];
+        if (faces.length === 0 || !faces[0]) {
+            throw new Error('No face detected in the image.');
+        }
+        const face = faces[0];
+        // Extract the embedding vector
+        const embedding = face.embedding ?? face.embeddings ?? face.vector;
+        if (!Array.isArray(embedding)) {
+            throw new Error('Face embedding output does not contain a valid embedding vector.');
+        }
+        const vector = embedding.map(Number);
+        // Extract optional bounding box [x1, y1, x2, y2] → { x, y, width, height }
+        const bbox = face.bbox ?? face.bounding_box ?? face.boundingBox;
+        const boundingBox = Array.isArray(bbox) && bbox.length >= 4
+            ? {
+                x: Number(bbox[0]),
+                y: Number(bbox[1]),
+                width: Number(bbox[2]) - Number(bbox[0]),
+                height: Number(bbox[3]) - Number(bbox[1]),
+            }
+            : undefined;
+        // Extract optional confidence
+        const det_score = face.det_score ?? face.confidence ?? face.score;
+        const confidence = typeof det_score === 'number' ? det_score : undefined;
+        return { vector, boundingBox, confidence };
+    }
+}
+//# sourceMappingURL=ReplicateFaceEmbeddingService.js.map