@framers/agentos 0.1.163 → 0.1.165

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

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

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

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

@@ -0,0 +1,7 @@
+/**
+ * @file index.ts
+ * Barrel export for face embedding services and utilities.
+ */
+export { cosineSimilarity, type FaceBoundingBox, type FaceEmbedding, type FaceComparisonResult, type IFaceEmbeddingService, } from './IFaceEmbeddingService.js';
+export { ReplicateFaceEmbeddingService, type ReplicateFaceEmbeddingConfig, } from './ReplicateFaceEmbeddingService.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/media/images/face/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,gBAAgB,EAChB,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,GAC3B,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EACL,6BAA6B,EAC7B,KAAK,4BAA4B,GAClC,MAAM,oCAAoC,CAAC"}

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

@@ -0,0 +1,7 @@
+/**
+ * @file index.ts
+ * Barrel export for face embedding services and utilities.
+ */
+export { cosineSimilarity, } from './IFaceEmbeddingService.js';
+export { ReplicateFaceEmbeddingService, } from './ReplicateFaceEmbeddingService.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/media/images/face/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,gBAAgB,GAKjB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EACL,6BAA6B,GAE9B,MAAM,oCAAoC,CAAC"}

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

@@ -3,6 +3,7 @@ export * from './IImageProvider.js';
 export * from './imageToBuffer.js';
 export * from './ImageOperationError.js';
 export * from './FallbackImageProxy.js';
+export { PolicyAwareImageRouter, type ImageProviderPreference } from './PolicyAwareImageRouter.js';
 export * from './providers/OpenAIImageProvider.js';
 export * from './providers/OpenRouterImageProvider.js';
 export * from './providers/ReplicateImageProvider.js';
@@ -10,6 +11,7 @@ export * from './providers/StabilityImageProvider.js';
 export * from './providers/StableDiffusionLocalProvider.js';
 export * from './providers/FluxImageProvider.js';
 export * from './providers/FalImageProvider.js';
+export { type FaceEmbedding, type IFaceEmbeddingService, ReplicateFaceEmbeddingService, type ReplicateFaceEmbeddingConfig, } from './face/index.js';
 export type ImageProviderFactory = () => IImageProvider;
 export declare function registerImageProviderFactory(providerId: string, factory: ImageProviderFactory): void;
 export declare function unregisterImageProviderFactory(providerId: string): void;

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/media/images/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAS1D,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,oCAAoC,CAAC;AACnD,cAAc,wCAAwC,CAAC;AACvD,cAAc,uCAAuC,CAAC;AACtD,cAAc,uCAAuC,CAAC;AACtD,cAAc,6CAA6C,CAAC;AAC5D,cAAc,kCAAkC,CAAC;AACjD,cAAc,iCAAiC,CAAC;AAEhD,MAAM,MAAM,oBAAoB,GAAG,MAAM,cAAc,CAAC;AAYxD,wBAAgB,4BAA4B,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,oBAAoB,GAAG,IAAI,CAEpG;AAED,wBAAgB,8BAA8B,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAEvE;AAED,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAEnE;AAED,wBAAgB,0BAA0B,IAAI,MAAM,EAAE,CAErD;AAED,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,cAAc,CAMtE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/media/images/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAS1D,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,OAAO,EAAE,sBAAsB,EAAE,KAAK,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AACnG,cAAc,oCAAoC,CAAC;AACnD,cAAc,wCAAwC,CAAC;AACvD,cAAc,uCAAuC,CAAC;AACtD,cAAc,uCAAuC,CAAC;AACtD,cAAc,6CAA6C,CAAC;AAC5D,cAAc,kCAAkC,CAAC;AACjD,cAAc,iCAAiC,CAAC;AAEhD,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,qBAAqB,EAC1B,6BAA6B,EAC7B,KAAK,4BAA4B,GAClC,MAAM,iBAAiB,CAAC;AAEzB,MAAM,MAAM,oBAAoB,GAAG,MAAM,cAAc,CAAC;AAYxD,wBAAgB,4BAA4B,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,oBAAoB,GAAG,IAAI,CAEpG;AAED,wBAAgB,8BAA8B,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAEvE;AAED,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAEnE;AAED,wBAAgB,0BAA0B,IAAI,MAAM,EAAE,CAErD;AAED,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,cAAc,CAMtE"}

package/dist/media/images/index.js

@@ -9,6 +9,7 @@ export * from './IImageProvider.js';
 export * from './imageToBuffer.js';
 export * from './ImageOperationError.js';
 export * from './FallbackImageProxy.js';
+export { PolicyAwareImageRouter } from './PolicyAwareImageRouter.js';
 export * from './providers/OpenAIImageProvider.js';
 export * from './providers/OpenRouterImageProvider.js';
 export * from './providers/ReplicateImageProvider.js';
@@ -16,6 +17,7 @@ export * from './providers/StabilityImageProvider.js';
 export * from './providers/StableDiffusionLocalProvider.js';
 export * from './providers/FluxImageProvider.js';
 export * from './providers/FalImageProvider.js';
+export { ReplicateFaceEmbeddingService, } from './face/index.js';
 const imageProviderFactories = new Map([
     ['openai', () => new OpenAIImageProvider()],
     ['openrouter', () => new OpenRouterImageProvider()],

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/media/images/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,EAAE,uBAAuB,EAAE,MAAM,wCAAwC,CAAC;AACjF,OAAO,EAAE,sBAAsB,EAAE,MAAM,uCAAuC,CAAC;AAC/E,OAAO,EAAE,sBAAsB,EAAE,MAAM,uCAAuC,CAAC;AAC/E,OAAO,EAAE,4BAA4B,EAAE,MAAM,6CAA6C,CAAC;AAC3F,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAEnE,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,oCAAoC,CAAC;AACnD,cAAc,wCAAwC,CAAC;AACvD,cAAc,uCAAuC,CAAC;AACtD,cAAc,uCAAuC,CAAC;AACtD,cAAc,6CAA6C,CAAC;AAC5D,cAAc,kCAAkC,CAAC;AACjD,cAAc,iCAAiC,CAAC;AAIhD,MAAM,sBAAsB,GAAG,IAAI,GAAG,CAA+B;IACnE,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI,mBAAmB,EAAE,CAAC;IAC3C,CAAC,YAAY,EAAE,GAAG,EAAE,CAAC,IAAI,uBAAuB,EAAE,CAAC;IACnD,CAAC,WAAW,EAAE,GAAG,EAAE,CAAC,IAAI,sBAAsB,EAAE,CAAC;IACjD,CAAC,WAAW,EAAE,GAAG,EAAE,CAAC,IAAI,sBAAsB,EAAE,CAAC;IACjD,CAAC,wBAAwB,EAAE,GAAG,EAAE,CAAC,IAAI,4BAA4B,EAAE,CAAC;IACpE,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,IAAI,iBAAiB,EAAE,CAAC;IACtC,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,IAAI,gBAAgB,EAAE,CAAC;CACtC,CAAC,CAAC;AAEH,MAAM,UAAU,4BAA4B,CAAC,UAAkB,EAAE,OAA6B;IAC5F,sBAAsB,CAAC,GAAG,CAAC,UAAU,CAAC,WAAW,EAAE,EAAE,OAAO,CAAC,CAAC;AAChE,CAAC;AAED,MAAM,UAAU,8BAA8B,CAAC,UAAkB;IAC/D,sBAAsB,CAAC,MAAM,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,UAAkB;IACxD,OAAO,sBAAsB,CAAC,GAAG,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC,CAAC;AAC9D,CAAC;AAED,MAAM,UAAU,0BAA0B;IACxC,OAAO,KAAK,CAAC,IAAI,CAAC,sBAAsB,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,UAAkB;IACpD,MAAM,OAAO,GAAG,sBAAsB,CAAC,GAAG,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC,CAAC;IACrE,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,mDAAmD,UAAU,IAAI,CAAC,CAAC;IACrF,CAAC;IACD,OAAO,OAAO,EAAE,CAAC;AACnB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/media/images/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,EAAE,uBAAuB,EAAE,MAAM,wCAAwC,CAAC;AACjF,OAAO,EAAE,sBAAsB,EAAE,MAAM,uCAAuC,CAAC;AAC/E,OAAO,EAAE,sBAAsB,EAAE,MAAM,uCAAuC,CAAC;AAC/E,OAAO,EAAE,4BAA4B,EAAE,MAAM,6CAA6C,CAAC;AAC3F,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAEnE,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,OAAO,EAAE,sBAAsB,EAAgC,MAAM,6BAA6B,CAAC;AACnG,cAAc,oCAAoC,CAAC;AACnD,cAAc,wCAAwC,CAAC;AACvD,cAAc,uCAAuC,CAAC;AACtD,cAAc,uCAAuC,CAAC;AACtD,cAAc,6CAA6C,CAAC;AAC5D,cAAc,kCAAkC,CAAC;AACjD,cAAc,iCAAiC,CAAC;AAEhD,OAAO,EAGL,6BAA6B,GAE9B,MAAM,iBAAiB,CAAC;AAIzB,MAAM,sBAAsB,GAAG,IAAI,GAAG,CAA+B;IACnE,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI,mBAAmB,EAAE,CAAC;IAC3C,CAAC,YAAY,EAAE,GAAG,EAAE,CAAC,IAAI,uBAAuB,EAAE,CAAC;IACnD,CAAC,WAAW,EAAE,GAAG,EAAE,CAAC,IAAI,sBAAsB,EAAE,CAAC;IACjD,CAAC,WAAW,EAAE,GAAG,EAAE,CAAC,IAAI,sBAAsB,EAAE,CAAC;IACjD,CAAC,wBAAwB,EAAE,GAAG,EAAE,CAAC,IAAI,4BAA4B,EAAE,CAAC;IACpE,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,IAAI,iBAAiB,EAAE,CAAC;IACtC,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,IAAI,gBAAgB,EAAE,CAAC;CACtC,CAAC,CAAC;AAEH,MAAM,UAAU,4BAA4B,CAAC,UAAkB,EAAE,OAA6B;IAC5F,sBAAsB,CAAC,GAAG,CAAC,UAAU,CAAC,WAAW,EAAE,EAAE,OAAO,CAAC,CAAC;AAChE,CAAC;AAED,MAAM,UAAU,8BAA8B,CAAC,UAAkB;IAC/D,sBAAsB,CAAC,MAAM,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,UAAkB;IACxD,OAAO,sBAAsB,CAAC,GAAG,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC,CAAC;AAC9D,CAAC;AAED,MAAM,UAAU,0BAA0B;IACxC,OAAO,KAAK,CAAC,IAAI,CAAC,sBAAsB,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,UAAkB;IACpD,MAAM,OAAO,GAAG,sBAAsB,CAAC,GAAG,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC,CAAC;IACrE,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,mDAAmD,UAAU,IAAI,CAAC,CAAC;IACrF,CAAC;IACD,OAAO,OAAO,EAAE,CAAC;AACnB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@framers/agentos",
-  "version": "0.1.163",
+  "version": "0.1.165",
   "description": "Modular AgentOS orchestration library",
   "type": "module",
   "main": "dist/index.js",