@framers/agentos 0.13.58 → 0.13.60

package/dist/io/media/images/styleTransfer.d.ts

@@ -0,0 +1,67 @@
+/**
+ * @file styleTransfer.ts
+ * What the providers' style transfers share: the prompt an editing model is
+ * sent, the check of the two images' formats, and the refusal of a model a
+ * provider's style transfer cannot run.
+ *
+ * OpenAI's edits endpoint and the FLUX.2 models change images by instruction
+ * and take no strength, so a style transfer sends them an instruction that
+ * names the two images, then the caller's prompt. `strength` picks the
+ * instruction, as `variance` picks the prompt of OpenAI's variations: below
+ * 0.5 a light restyle that keeps most of the source's own colours, otherwise
+ * a full one.
+ */
+import { type ImagePartType } from './blobPart.js';
+/** The strength a style transfer uses when the call gives none. */
+export declare const STYLE_TRANSFER_DEFAULT_STRENGTH = 0.7;
+/** How a model is told which image is which: by index for FLUX.2, in words for OpenAI. */
+export interface StyleTransferImageNames {
+    /** The image to restyle, sent first. */
+    source: string;
+    /** The image whose style is applied, sent second. */
+    style: string;
+}
+/** FLUX.2's names: "point to other reference images by their index number" (https://replicate.com/black-forest-labs/flux-2-pro). */
+export declare const INDEXED_IMAGE_NAMES: StyleTransferImageNames;
+/** OpenAI's names, in the order the images are sent. */
+export declare const ORDINAL_IMAGE_NAMES: StyleTransferImageNames;
+/**
+ * The instruction alone, for a strength from 0 to 1 (default 0.7).
+ *
+ * @param strength - How much of the reference's style to apply.
+ * @param names - How the model is told which image is which.
+ */
+export declare function styleTransferInstruction(strength: number | undefined, names: StyleTransferImageNames): string;
+/**
+ * The prompt for a style transfer on an editing model: the instruction, then
+ * the caller's prompt when it has text.
+ *
+ * @param prompt - The caller's prompt.
+ * @param strength - How much of the reference's style to apply.
+ * @param names - How the model is told which image is which.
+ */
+export declare function styleTransferPrompt(prompt: string, strength: number | undefined, names: StyleTransferImageNames): string;
+/**
+ * The formats of the two images, checked against those a provider takes.
+ *
+ * @param provider - The provider's name, for the error.
+ * @param accepted - The formats it takes, by media type.
+ * @param image - The source.
+ * @param styleImage - The style reference.
+ * @returns Each image's format.
+ * @throws {Error} When either image is not a PNG, JPEG, WebP or GIF, or is a
+ *   format the provider does not take.
+ */
+export declare function styleTransferImageTypes(provider: string, accepted: readonly ImagePartType['mimeType'][], image: Buffer, styleImage: Buffer): {
+    image: ImagePartType;
+    style: ImagePartType;
+};
+/**
+ * The error for a model outside a provider's style-transfer models.
+ *
+ * @param provider - The provider's name.
+ * @param model - The model the call named.
+ * @param models - The models it runs, the default first.
+ */
+export declare function styleTransferModelError(provider: string, model: string, models: readonly string[]): Error;
+//# sourceMappingURL=styleTransfer.d.ts.map

package/dist/io/media/images/styleTransfer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"styleTransfer.d.ts","sourceRoot":"","sources":["../../../../src/io/media/images/styleTransfer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAmC,KAAK,aAAa,EAAE,MAAM,eAAe,CAAC;AAEpF,mEAAmE;AACnE,eAAO,MAAM,+BAA+B,MAAM,CAAC;AAEnD,0FAA0F;AAC1F,MAAM,WAAW,uBAAuB;IACtC,wCAAwC;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,qDAAqD;IACrD,KAAK,EAAE,MAAM,CAAC;CACf;AAED,oIAAoI;AACpI,eAAO,MAAM,mBAAmB,EAAE,uBAAiE,CAAC;AAEpG,wDAAwD;AACxD,eAAO,MAAM,mBAAmB,EAAE,uBAAkF,CAAC;AAErH;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE,KAAK,EAAE,uBAAuB,GAAG,MAAM,CAK7G;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE,KAAK,EAAE,uBAAuB,GAAG,MAAM,CAIxH;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,SAAS,aAAa,CAAC,UAAU,CAAC,EAAE,EAC9C,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,GACjB;IAAE,KAAK,EAAE,aAAa,CAAC;IAAC,KAAK,EAAE,aAAa,CAAA;CAAE,CAYhD;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,KAAK,CAIzG"}

package/dist/io/media/images/styleTransfer.js

@@ -0,0 +1,78 @@
+/**
+ * @file styleTransfer.ts
+ * What the providers' style transfers share: the prompt an editing model is
+ * sent, the check of the two images' formats, and the refusal of a model a
+ * provider's style transfer cannot run.
+ *
+ * OpenAI's edits endpoint and the FLUX.2 models change images by instruction
+ * and take no strength, so a style transfer sends them an instruction that
+ * names the two images, then the caller's prompt. `strength` picks the
+ * instruction, as `variance` picks the prompt of OpenAI's variations: below
+ * 0.5 a light restyle that keeps most of the source's own colours, otherwise
+ * a full one.
+ */
+import { IMAGE_PART_TYPES, imagePartType } from './blobPart.js';
+/** The strength a style transfer uses when the call gives none. */
+export const STYLE_TRANSFER_DEFAULT_STRENGTH = 0.7;
+/** FLUX.2's names: "point to other reference images by their index number" (https://replicate.com/black-forest-labs/flux-2-pro). */
+export const INDEXED_IMAGE_NAMES = { source: 'image 1', style: 'image 2' };
+/** OpenAI's names, in the order the images are sent. */
+export const ORDINAL_IMAGE_NAMES = { source: 'the first image', style: 'the second image' };
+/**
+ * The instruction alone, for a strength from 0 to 1 (default 0.7).
+ *
+ * @param strength - How much of the reference's style to apply.
+ * @param names - How the model is told which image is which.
+ */
+export function styleTransferInstruction(strength, names) {
+    const { source, style } = names;
+    return (strength ?? STYLE_TRANSFER_DEFAULT_STRENGTH) < 0.5
+        ? `Restyle ${source} lightly after ${style}: keep ${source}'s subject, composition, pose and most of its own colours, and take ${style}'s texture, brushwork and lighting.`
+        : `Restyle ${source} in the style of ${style}: keep ${source}'s subject, composition and pose, and take ${style}'s palette, brushwork, texture, lighting and medium.`;
+}
+/**
+ * The prompt for a style transfer on an editing model: the instruction, then
+ * the caller's prompt when it has text.
+ *
+ * @param prompt - The caller's prompt.
+ * @param strength - How much of the reference's style to apply.
+ * @param names - How the model is told which image is which.
+ */
+export function styleTransferPrompt(prompt, strength, names) {
+    const instruction = styleTransferInstruction(strength, names);
+    const text = prompt.trim();
+    return text ? `${instruction} ${text}` : instruction;
+}
+/**
+ * The formats of the two images, checked against those a provider takes.
+ *
+ * @param provider - The provider's name, for the error.
+ * @param accepted - The formats it takes, by media type.
+ * @param image - The source.
+ * @param styleImage - The style reference.
+ * @returns Each image's format.
+ * @throws {Error} When either image is not a PNG, JPEG, WebP or GIF, or is a
+ *   format the provider does not take.
+ */
+export function styleTransferImageTypes(provider, accepted, image, styleImage) {
+    const check = (bytes, which) => {
+        const type = imagePartType(bytes);
+        if (!type || !accepted.includes(type.mimeType)) {
+            const formats = accepted.map((mimeType) => IMAGE_PART_TYPES[mimeType].name).join(', ');
+            throw new Error(`${provider}'s style transfer takes ${formats}; the ${which} is ${type ? type.name : 'not a JPEG, PNG, WebP or GIF image'}.`);
+        }
+        return type;
+    };
+    return { image: check(image, 'source'), style: check(styleImage, 'style reference') };
+}
+/**
+ * The error for a model outside a provider's style-transfer models.
+ *
+ * @param provider - The provider's name.
+ * @param model - The model the call named.
+ * @param models - The models it runs, the default first.
+ */
+export function styleTransferModelError(provider, model, models) {
+    return new Error(`${provider}'s style transfer runs on ${models.join(', ')} (${models[0]} by default); ${model} is not one of them. A custom baseUrl takes any model name.`);
+}
+//# sourceMappingURL=styleTransfer.js.map

package/dist/io/media/images/styleTransfer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"styleTransfer.js","sourceRoot":"","sources":["../../../../src/io/media/images/styleTransfer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAsB,MAAM,eAAe,CAAC;AAEpF,mEAAmE;AACnE,MAAM,CAAC,MAAM,+BAA+B,GAAG,GAAG,CAAC;AAUnD,oIAAoI;AACpI,MAAM,CAAC,MAAM,mBAAmB,GAA4B,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;AAEpG,wDAAwD;AACxD,MAAM,CAAC,MAAM,mBAAmB,GAA4B,EAAE,MAAM,EAAE,iBAAiB,EAAE,KAAK,EAAE,kBAAkB,EAAE,CAAC;AAErH;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB,CAAC,QAA4B,EAAE,KAA8B;IACnG,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC;IAChC,OAAO,CAAC,QAAQ,IAAI,+BAA+B,CAAC,GAAG,GAAG;QACxD,CAAC,CAAC,WAAW,MAAM,kBAAkB,KAAK,UAAU,MAAM,uEAAuE,KAAK,qCAAqC;QAC3K,CAAC,CAAC,WAAW,MAAM,oBAAoB,KAAK,UAAU,MAAM,8CAA8C,KAAK,sDAAsD,CAAC;AAC1K,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAc,EAAE,QAA4B,EAAE,KAA8B;IAC9G,MAAM,WAAW,GAAG,wBAAwB,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IAC9D,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;IAC3B,OAAO,IAAI,CAAC,CAAC,CAAC,GAAG,WAAW,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC;AACvD,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,uBAAuB,CACrC,QAAgB,EAChB,QAA8C,EAC9C,KAAa,EACb,UAAkB;IAElB,MAAM,KAAK,GAAG,CAAC,KAAa,EAAE,KAAa,EAAiB,EAAE;QAC5D,MAAM,IAAI,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;QAClC,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC/C,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACvF,MAAM,IAAI,KAAK,CACb,GAAG,QAAQ,2BAA2B,OAAO,SAAS,KAAK,OAAO,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,oCAAoC,GAAG,CAC7H,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC,CAAC;IACF,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,QAAQ,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,UAAU,EAAE,iBAAiB,CAAC,EAAE,CAAC;AACxF,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,uBAAuB,CAAC,QAAgB,EAAE,KAAa,EAAE,MAAyB;IAChG,OAAO,IAAI,KAAK,CACd,GAAG,QAAQ,6BAA6B,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC,iBAAiB,KAAK,6DAA6D,CAC3J,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@framers/agentos",
-  "version": "0.13.58",
+  "version": "0.13.60",
   "description": "AgentOS: open-source TypeScript framework for autonomous AI agents. Unified graph orchestration, cognitive memory, runtime tool forging, multi-tier guardrails, voice pipeline, and 11 LLM providers.",
   "homepage": "https://agentos.sh",
   "repository": {