@framers/agentos 0.1.163 → 0.1.165

package/dist/media/avatar/AvatarPipeline.js

@@ -0,0 +1,308 @@
+/**
+ * @file AvatarPipeline.ts
+ * Core orchestrator for staged avatar image generation.
+ *
+ * Executes the avatar pipeline stages in order — neutral portrait, face
+ * embedding extraction, expression sheet, animated emotes, full body —
+ * with cosine-similarity drift checking against the anchor face embedding.
+ * Images that drift too far from the anchor are regenerated up to a
+ * configurable maximum number of attempts.
+ */
+import { randomUUID } from 'crypto';
+import { AVATAR_EMOTIONS, buildPortraitPrompt, buildExpressionPrompt, buildEmotePrompt } from './prompts.js';
+// ---------------------------------------------------------------------------
+// Default thresholds
+// ---------------------------------------------------------------------------
+const DEFAULT_DRIFT_SIMILARITY = 0.6;
+const DEFAULT_REJECT_BELOW_THRESHOLD = true;
+const DEFAULT_MAX_REGEN_ATTEMPTS = 3;
+const ALL_STAGES = [
+    'neutral_portrait',
+    'face_embedding',
+    'expression_sheet',
+    'animated_emotes',
+    'full_body',
+];
+// ---------------------------------------------------------------------------
+// Pipeline
+// ---------------------------------------------------------------------------
+/**
+ * Orchestrates multi-stage avatar image generation with drift detection.
+ *
+ * Stages run in dependency order. The expression sheet and animated emote
+ * stages drift-check each generated image against the anchor face embedding
+ * and regenerate on low similarity.
+ */
+export class AvatarPipeline {
+    /**
+     * @param faceService - Face embedding extraction and comparison service.
+     * @param generateImage - Image generation function (prompt → URL).
+     */
+    constructor(faceService, generateImage) {
+        this.faceService = faceService;
+        this.generateImage = generateImage;
+    }
+    /**
+     * Execute the avatar generation pipeline.
+     *
+     * @param request - Generation request with identity, stages, and config.
+     * @returns Result containing the identity package, job records, and drift report.
+     */
+    async generate(request) {
+        const startTime = Date.now();
+        const stages = request.stages ?? ALL_STAGES;
+        const jobs = [];
+        const driftConfig = {
+            faceSimilarity: request.driftGuard?.faceSimilarity ?? DEFAULT_DRIFT_SIMILARITY,
+            rejectBelowThreshold: request.driftGuard?.rejectBelowThreshold ?? DEFAULT_REJECT_BELOW_THRESHOLD,
+            maxRegenerationAttempts: request.driftGuard?.maxRegenerationAttempts ?? DEFAULT_MAX_REGEN_ATTEMPTS,
+        };
+        // Mutable state accumulated across stages
+        let neutralPortraitUrl = request.existingAnchors?.neutralPortrait ?? '';
+        let faceEmbedding = request.existingAnchors?.faceEmbedding;
+        const expressionSheet = {};
+        const animatedEmotes = {};
+        let fullBodyUrl;
+        const driftScores = {};
+        const driftRejected = [];
+        const driftRegenerated = [];
+        // -----------------------------------------------------------------------
+        // Stage: neutral_portrait
+        // -----------------------------------------------------------------------
+        if (stages.includes('neutral_portrait') && !neutralPortraitUrl) {
+            const job = this.createJob('neutral_portrait', 'neutral_portrait');
+            const jobStart = Date.now();
+            try {
+                job.status = 'running';
+                const prompt = buildPortraitPrompt(request.identity);
+                neutralPortraitUrl = await this.generateImage(prompt, {
+                    seed: request.generationConfig.seed,
+                    negativePrompt: request.generationConfig.negativePrompt,
+                    stylePreset: request.generationConfig.stylePreset,
+                    policyTier: request.policyTier,
+                });
+                job.imageUrl = neutralPortraitUrl;
+                job.status = 'completed';
+                job.attempts = 1;
+            }
+            catch (err) {
+                job.status = 'failed';
+                job.error = err instanceof Error ? err.message : String(err);
+            }
+            job.durationMs = Date.now() - jobStart;
+            jobs.push(job);
+        }
+        // -----------------------------------------------------------------------
+        // Stage: face_embedding
+        // -----------------------------------------------------------------------
+        if (stages.includes('face_embedding') && !faceEmbedding && neutralPortraitUrl) {
+            const job = this.createJob('face_embedding', 'face_embedding');
+            const jobStart = Date.now();
+            try {
+                job.status = 'running';
+                const result = await this.faceService.extractEmbedding(neutralPortraitUrl);
+                faceEmbedding = result.vector;
+                job.status = 'completed';
+                job.attempts = 1;
+            }
+            catch (err) {
+                job.status = 'failed';
+                job.error = err instanceof Error ? err.message : String(err);
+            }
+            job.durationMs = Date.now() - jobStart;
+            jobs.push(job);
+        }
+        // -----------------------------------------------------------------------
+        // Stage: expression_sheet
+        // -----------------------------------------------------------------------
+        if (stages.includes('expression_sheet')) {
+            for (const emotion of AVATAR_EMOTIONS) {
+                // Neutral portrait is already the anchor; skip re-generating it
+                if (emotion === 'neutral') {
+                    if (neutralPortraitUrl) {
+                        expressionSheet.neutral = neutralPortraitUrl;
+                    }
+                    continue;
+                }
+                const label = `expression:${emotion}`;
+                const job = this.createJob('expression_sheet', label);
+                const jobStart = Date.now();
+                try {
+                    job.status = 'running';
+                    const prompt = buildExpressionPrompt(request.identity, emotion);
+                    let imageUrl;
+                    let bestScore = -1;
+                    let attempts = 0;
+                    while (attempts < driftConfig.maxRegenerationAttempts) {
+                        attempts++;
+                        const url = await this.generateImage(prompt, {
+                            seed: request.generationConfig.seed,
+                            negativePrompt: request.generationConfig.negativePrompt,
+                            stylePreset: request.generationConfig.stylePreset,
+                            policyTier: request.policyTier,
+                            referenceImageUrl: neutralPortraitUrl || undefined,
+                        });
+                        // Drift check against anchor embedding
+                        if (faceEmbedding) {
+                            try {
+                                const generated = await this.faceService.extractEmbedding(url);
+                                const comparison = this.faceService.compareFaces(faceEmbedding, generated.vector, driftConfig.faceSimilarity);
+                                if (comparison.similarity > bestScore) {
+                                    bestScore = comparison.similarity;
+                                    imageUrl = url;
+                                }
+                                if (comparison.match) {
+                                    break; // Acceptable drift
+                                }
+                                if (attempts > 1) {
+                                    driftRegenerated.push(label);
+                                }
+                            }
+                            catch {
+                                // If face extraction fails on the generated image, accept it
+                                imageUrl = url;
+                                break;
+                            }
+                        }
+                        else {
+                            // No anchor embedding available — accept the first result
+                            imageUrl = url;
+                            break;
+                        }
+                    }
+                    if (imageUrl) {
+                        expressionSheet[emotion] = imageUrl;
+                        job.imageUrl = imageUrl;
+                        job.driftScore = bestScore >= 0 ? bestScore : undefined;
+                        job.status = 'completed';
+                        if (bestScore >= 0) {
+                            driftScores[label] = bestScore;
+                            if (bestScore < driftConfig.faceSimilarity && driftConfig.rejectBelowThreshold) {
+                                driftRejected.push(label);
+                            }
+                        }
+                    }
+                    else {
+                        job.status = 'failed';
+                        job.error = 'All regeneration attempts failed drift check.';
+                    }
+                    job.attempts = attempts;
+                }
+                catch (err) {
+                    job.status = 'failed';
+                    job.error = err instanceof Error ? err.message : String(err);
+                }
+                job.durationMs = Date.now() - jobStart;
+                jobs.push(job);
+            }
+        }
+        // -----------------------------------------------------------------------
+        // Stage: animated_emotes
+        // -----------------------------------------------------------------------
+        if (stages.includes('animated_emotes')) {
+            for (const emotion of AVATAR_EMOTIONS) {
+                const label = `emote:${emotion}`;
+                const job = this.createJob('animated_emotes', label);
+                const jobStart = Date.now();
+                try {
+                    job.status = 'running';
+                    const prompt = buildEmotePrompt(emotion);
+                    const url = await this.generateImage(prompt, {
+                        seed: request.generationConfig.seed,
+                        negativePrompt: request.generationConfig.negativePrompt,
+                        policyTier: request.policyTier,
+                    });
+                    animatedEmotes[emotion] = url;
+                    job.imageUrl = url;
+                    job.status = 'completed';
+                    job.attempts = 1;
+                }
+                catch (err) {
+                    job.status = 'failed';
+                    job.error = err instanceof Error ? err.message : String(err);
+                }
+                job.durationMs = Date.now() - jobStart;
+                jobs.push(job);
+            }
+        }
+        // -----------------------------------------------------------------------
+        // Stage: full_body
+        // -----------------------------------------------------------------------
+        if (stages.includes('full_body')) {
+            const job = this.createJob('full_body', 'full_body');
+            const jobStart = Date.now();
+            try {
+                job.status = 'running';
+                const basePrompt = buildPortraitPrompt(request.identity);
+                const prompt = basePrompt.replace(/^portrait of/, 'full body shot of');
+                fullBodyUrl = await this.generateImage(prompt, {
+                    seed: request.generationConfig.seed,
+                    negativePrompt: request.generationConfig.negativePrompt,
+                    stylePreset: request.generationConfig.stylePreset,
+                    policyTier: request.policyTier,
+                    referenceImageUrl: neutralPortraitUrl || undefined,
+                });
+                job.imageUrl = fullBodyUrl;
+                job.status = 'completed';
+                job.attempts = 1;
+            }
+            catch (err) {
+                job.status = 'failed';
+                job.error = err instanceof Error ? err.message : String(err);
+            }
+            job.durationMs = Date.now() - jobStart;
+            jobs.push(job);
+        }
+        // -----------------------------------------------------------------------
+        // Assemble identity package
+        // -----------------------------------------------------------------------
+        const now = new Date().toISOString();
+        const identityPackage = {
+            id: randomUUID(),
+            characterId: request.characterId,
+            identity: request.identity,
+            anchors: {
+                neutralPortrait: neutralPortraitUrl,
+                expressionSheet: Object.keys(expressionSheet).length > 0 ? expressionSheet : undefined,
+                animatedEmotes: Object.keys(animatedEmotes).length > 0 ? animatedEmotes : undefined,
+                fullBody: fullBodyUrl,
+            },
+            faceEmbedding,
+            driftGuard: driftConfig,
+            generationConfig: request.generationConfig,
+            createdAt: now,
+            updatedAt: now,
+        };
+        // -----------------------------------------------------------------------
+        // Drift report
+        // -----------------------------------------------------------------------
+        let driftReport;
+        if (faceEmbedding) {
+            driftReport = {
+                anchorEmbeddingDim: faceEmbedding.length,
+                scores: driftScores,
+                rejected: driftRejected,
+                regenerated: [...new Set(driftRegenerated)],
+                passed: driftRejected.length === 0,
+            };
+        }
+        return {
+            identityPackage,
+            jobs,
+            driftReport,
+            totalDurationMs: Date.now() - startTime,
+        };
+    }
+    // -------------------------------------------------------------------------
+    // Helpers
+    // -------------------------------------------------------------------------
+    createJob(stage, label) {
+        return {
+            stage,
+            label,
+            status: 'pending',
+            attempts: 0,
+        };
+    }
+}
+//# sourceMappingURL=AvatarPipeline.js.map

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"}