@venturekit-pro/ai 0.0.24 → 0.0.25

package/dist/image/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/image/client.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,sBAAsB,EACtB,qBAAqB,EACrB,aAAa,EACd,MAAM,YAAY,CAAC;AACpB,OAAO,EAA4B,KAAK,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAEtF;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;CAC3E;AAED;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAAE,QAAQ,EAAE,QAAQ,CAAA;CAAE,GAAG,wBAAwB,CAAC;AAElF;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,iBAAiB,GAAG,qBAAqB,CAclF"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/image/client.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,sBAAsB,EACtB,qBAAqB,EACrB,aAAa,EACd,MAAM,YAAY,CAAC;AACpB,OAAO,EAA2B,KAAK,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAErF;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;CAC3E;AAED;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAAE,QAAQ,EAAE,QAAQ,CAAA;CAAE,GAAG,wBAAwB,CAAC;AAElF;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,iBAAiB,GAAG,qBAAqB,CAclF"}

package/dist/image/client.js

@@ -6,7 +6,7 @@
  * and call `.generate()` against it. The factory switches on `provider`
  * once, at construction.
  */
-import { generateWithGoogleImagen } from './google.js';
+import { generateWithGoogleImage } from './google.js';
 /**
  * Build an image client. Throws synchronously on an unknown provider so
  * the caller fails fast rather than at the first `.generate()` call.
@@ -19,7 +19,7 @@ export function createImageClient(config) {
     void _ignored;
     return {
         provider: 'google',
-        generate: (request) => generateWithGoogleImagen(adapterConfig, request),
+        generate: (request) => generateWithGoogleImage(adapterConfig, request),
     };
 }
 //# sourceMappingURL=client.js.map

package/dist/image/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/image/client.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,OAAO,EAAE,wBAAwB,EAAiC,MAAM,aAAa,CAAC;AAkBtF;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAyB;IACzD,IAAI,MAAM,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CACb,oCAAoC,MAAM,CACvC,MAA+B,CAAC,QAAQ,CAC1C,EAAE,CACJ,CAAC;IACJ,CAAC;IACD,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,aAAa,EAAE,GAAG,MAAM,CAAC;IACxD,KAAK,QAAQ,CAAC;IACd,OAAO;QACL,QAAQ,EAAE,QAAQ;QAClB,QAAQ,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,wBAAwB,CAAC,aAAa,EAAE,OAAO,CAAC;KACxE,CAAC;AACJ,CAAC"}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/image/client.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,OAAO,EAAE,uBAAuB,EAAiC,MAAM,aAAa,CAAC;AAkBrF;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAyB;IACzD,IAAI,MAAM,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CACb,oCAAoC,MAAM,CACvC,MAA+B,CAAC,QAAQ,CAC1C,EAAE,CACJ,CAAC;IACJ,CAAC;IACD,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,aAAa,EAAE,GAAG,MAAM,CAAC;IACxD,KAAK,QAAQ,CAAC;IACd,OAAO;QACL,QAAQ,EAAE,QAAQ;QAClB,QAAQ,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,uBAAuB,CAAC,aAAa,EAAE,OAAO,CAAC;KACvE,CAAC;AACJ,CAAC"}

package/dist/image/google.d.ts

@@ -1,14 +1,32 @@
 /**
- * Google Imagen adapter (Generative Language REST API).
+ * Google image adapter (Generative Language REST API).
  *
- * Talks to the `:predict` endpoint on
- * `generativelanguage.googleapis.com` — the documented Imagen REST
- * surface: an `{ instances, parameters }` request that returns
- * `predictions[]`. We request one image per call and loop `count`
- * times, collecting the bytes.
+ * Targets the **Interactions API** — `POST /v1beta/interactions` on
+ * `generativelanguage.googleapis.com` — which is the surface the
+ * Gemini image models (`gemini-3.1-flash-image` "Nano Banana 2",
+ * `gemini-3.1-flash-lite-image`, `gemini-3-pro-image`) are served on.
  *
- * Auth is via the `?key=` query param (the documented REST form for
- * Generative Language API keys), escaped through `encodeURIComponent`.
+ * # Why this is not the Imagen `:predict` surface any more
+ *
+ * This adapter previously spoke Imagen's `:predict` protocol
+ * (`{ instances, parameters }` in, `predictions[]` out). Google retired
+ * the ENTIRE Imagen line: `imagen-4.0-generate-001`,
+ * `imagen-4.0-ultra-generate-001` and `imagen-4.0-fast-generate-001`
+ * were shut down on 2026-08-17, `imagen-3.0-generate-002` earlier, and
+ * there is no Imagen 5 — the published replacement for all of them is
+ * `gemini-3.1-flash-image`. Those models do not answer on `:predict`,
+ * so this is a protocol change, not a model-id change.
+ *
+ * Three things differ from the old surface:
+ *   - the model travels in the request BODY, not the URL path;
+ *   - auth is the `x-goog-api-key` HEADER, not a `?key=` query param;
+ *   - framing moves from `parameters.aspectRatio` to
+ *     `response_format.aspect_ratio`, and the response carries content
+ *     blocks (`steps[].content[]` with `type: 'image'`) instead of
+ *     `predictions[]`.
+ *
+ * As before we request one image per call and loop `count` times,
+ * collecting the bytes: a single interaction yields a single image.
  */
 import type { ImageGenerationRequest, ImageGenerationResult } from './types.js';
 export interface GoogleImageAdapterConfig {
@@ -20,5 +38,11 @@ export interface GoogleImageAdapterConfig {
     /** Request timeout in milliseconds. Default 120s — image gen is slow. */
     timeoutMs?: number;
 }
-export declare function generateWithGoogleImagen(config: GoogleImageAdapterConfig, request: ImageGenerationRequest): Promise<ImageGenerationResult>;
+export declare function generateWithGoogleImage(config: GoogleImageAdapterConfig, request: ImageGenerationRequest): Promise<ImageGenerationResult>;
+/**
+ * @deprecated Renamed to {@link generateWithGoogleImage} now that the
+ * adapter no longer targets Imagen. Kept as an alias so existing
+ * imports keep resolving; drop it on the next breaking release.
+ */
+export declare const generateWithGoogleImagen: typeof generateWithGoogleImage;
 //# sourceMappingURL=google.d.ts.map

package/dist/image/google.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"google.d.ts","sourceRoot":"","sources":["../../src/image/google.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAEV,sBAAsB,EACtB,qBAAqB,EACtB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,sFAAsF;IACtF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yCAAyC;IACzC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yEAAyE;IACzE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAMD,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,wBAAwB,EAChC,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,qBAAqB,CAAC,CA4DhC"}
+{"version":3,"file":"google.d.ts","sourceRoot":"","sources":["../../src/image/google.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,KAAK,EAEV,sBAAsB,EACtB,qBAAqB,EACtB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,sFAAsF;IACtF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yCAAyC;IACzC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yEAAyE;IACzE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAkCD,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,wBAAwB,EAChC,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,qBAAqB,CAAC,CAsEhC;AAED;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,gCAA0B,CAAC"}

package/dist/image/google.js

@@ -1,16 +1,49 @@
 /**
- * Google Imagen adapter (Generative Language REST API).
+ * Google image adapter (Generative Language REST API).
  *
- * Talks to the `:predict` endpoint on
- * `generativelanguage.googleapis.com` — the documented Imagen REST
- * surface: an `{ instances, parameters }` request that returns
- * `predictions[]`. We request one image per call and loop `count`
- * times, collecting the bytes.
+ * Targets the **Interactions API** — `POST /v1beta/interactions` on
+ * `generativelanguage.googleapis.com` — which is the surface the
+ * Gemini image models (`gemini-3.1-flash-image` "Nano Banana 2",
+ * `gemini-3.1-flash-lite-image`, `gemini-3-pro-image`) are served on.
  *
- * Auth is via the `?key=` query param (the documented REST form for
- * Generative Language API keys), escaped through `encodeURIComponent`.
+ * # Why this is not the Imagen `:predict` surface any more
+ *
+ * This adapter previously spoke Imagen's `:predict` protocol
+ * (`{ instances, parameters }` in, `predictions[]` out). Google retired
+ * the ENTIRE Imagen line: `imagen-4.0-generate-001`,
+ * `imagen-4.0-ultra-generate-001` and `imagen-4.0-fast-generate-001`
+ * were shut down on 2026-08-17, `imagen-3.0-generate-002` earlier, and
+ * there is no Imagen 5 — the published replacement for all of them is
+ * `gemini-3.1-flash-image`. Those models do not answer on `:predict`,
+ * so this is a protocol change, not a model-id change.
+ *
+ * Three things differ from the old surface:
+ *   - the model travels in the request BODY, not the URL path;
+ *   - auth is the `x-goog-api-key` HEADER, not a `?key=` query param;
+ *   - framing moves from `parameters.aspectRatio` to
+ *     `response_format.aspect_ratio`, and the response carries content
+ *     blocks (`steps[].content[]` with `type: 'image'`) instead of
+ *     `predictions[]`.
+ *
+ * As before we request one image per call and loop `count` times,
+ * collecting the bytes: a single interaction yields a single image.
+ */
+/**
+ * First image block in the response, scanning every step. The image
+ * models default to returning conversational text ALONGSIDE the image,
+ * so the block of interest is not reliably at a fixed index — we pin on
+ * `type === 'image'` rather than position.
  */
-export async function generateWithGoogleImagen(config, request) {
+function findImageBlock(json) {
+    for (const step of json.steps ?? []) {
+        for (const block of step.content ?? []) {
+            if (block.type === 'image' && block.data)
+                return block;
+        }
+    }
+    return undefined;
+}
+export async function generateWithGoogleImage(config, request) {
     const startedAt = Date.now();
     const baseUrl = (config.baseUrl ?? 'https://generativelanguage.googleapis.com').replace(/\/+$/, '');
     const apiVersion = config.apiVersion ?? 'v1beta';
@@ -19,7 +52,9 @@ export async function generateWithGoogleImagen(config, request) {
     // upper cap appropriate to its quota.
     const count = Math.max(1, request.count ?? 1);
     const aspectRatio = request.aspectRatio ?? '16:9';
-    const url = `${baseUrl}/${apiVersion}/models/${encodeURIComponent(request.model)}:predict?key=${encodeURIComponent(config.apiKey)}`;
+    const imageSize = request.imageSize;
+    // Single fixed endpoint: the model is a body field on this API.
+    const url = `${baseUrl}/${apiVersion}/interactions`;
     const images = [];
     for (let i = 0; i < count; i++) {
         const controller = new AbortController();
@@ -28,10 +63,20 @@ export async function generateWithGoogleImagen(config, request) {
         try {
             response = await fetch(url, {
                 method: 'POST',
-                headers: { 'Content-Type': 'application/json' },
+                headers: {
+                    'Content-Type': 'application/json',
+                    'x-goog-api-key': config.apiKey,
+                },
                 body: JSON.stringify({
-                    instances: [{ prompt: request.prompt }],
-                    parameters: { sampleCount: 1, aspectRatio },
+                    model: request.model,
+                    input: request.prompt,
+                    // Asking for `image` only suppresses the conversational text
+                    // the model would otherwise return next to the picture.
+                    response_format: {
+                        type: 'image',
+                        aspect_ratio: aspectRatio,
+                        ...(imageSize ? { image_size: imageSize } : {}),
+                    },
                 }),
                 signal: controller.signal,
             });
@@ -44,13 +89,13 @@ export async function generateWithGoogleImagen(config, request) {
             throw new Error(`[ai/image/google] ${response.status} ${response.statusText}: ${text}`);
         }
         const json = (await response.json());
-        const im = json.predictions?.[0];
-        if (!im?.bytesBase64Encoded) {
+        const im = findImageBlock(json);
+        if (!im?.data) {
             throw new Error('[ai/image/google] No image bytes returned');
         }
         images.push({
-            bytes: Uint8Array.from(Buffer.from(im.bytesBase64Encoded, 'base64')),
-            mimeType: im.mimeType ?? 'image/png',
+            bytes: Uint8Array.from(Buffer.from(im.data, 'base64')),
+            mimeType: im.mime_type ?? 'image/png',
         });
     }
     return {
@@ -60,4 +105,10 @@ export async function generateWithGoogleImagen(config, request) {
         latencyMs: Date.now() - startedAt,
     };
 }
+/**
+ * @deprecated Renamed to {@link generateWithGoogleImage} now that the
+ * adapter no longer targets Imagen. Kept as an alias so existing
+ * imports keep resolving; drop it on the next breaking release.
+ */
+export const generateWithGoogleImagen = generateWithGoogleImage;
 //# sourceMappingURL=google.js.map

package/dist/image/google.js.map

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

package/dist/image/index.d.ts

@@ -1,11 +1,12 @@
 /**
  * Image generation — provider-neutral text-to-image with raw byte
- * output. Currently Google Imagen; mirrors `chat/` in shape (no tool
- * use, no editing).
+ * output. Currently the Google Gemini image models (Nano Banana) via
+ * the Interactions API; mirrors `chat/` in shape (no tool use, no
+ * editing).
  */
-export type { ImageProvider, ImageAspectRatio, ImageGenerationRequest, ImageGenerationResult, GeneratedImage, } from './types.js';
+export type { ImageProvider, ImageAspectRatio, ImageOutputSize, ImageGenerationRequest, ImageGenerationResult, GeneratedImage, } from './types.js';
 export { createImageClient } from './client.js';
 export type { ImageGenerationClient, ImageClientConfig } from './client.js';
-export { generateWithGoogleImagen } from './google.js';
+export { generateWithGoogleImage, generateWithGoogleImagen } from './google.js';
 export type { GoogleImageAdapterConfig } from './google.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/image/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/image/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY,EACV,aAAa,EACb,gBAAgB,EAChB,sBAAsB,EACtB,qBAAqB,EACrB,cAAc,GACf,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,YAAY,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAG5E,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AACvD,YAAY,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/image/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,YAAY,EACV,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,sBAAsB,EACtB,qBAAqB,EACrB,cAAc,GACf,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,YAAY,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAI5E,OAAO,EAAE,uBAAuB,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAChF,YAAY,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC"}

package/dist/image/index.js

@@ -1,9 +1,11 @@
 /**
  * Image generation — provider-neutral text-to-image with raw byte
- * output. Currently Google Imagen; mirrors `chat/` in shape (no tool
- * use, no editing).
+ * output. Currently the Google Gemini image models (Nano Banana) via
+ * the Interactions API; mirrors `chat/` in shape (no tool use, no
+ * editing).
  */
 export { createImageClient } from './client.js';
 // Adapter exported for callers that want to bypass the factory.
-export { generateWithGoogleImagen } from './google.js';
+// `generateWithGoogleImagen` is a deprecated alias of the same function.
+export { generateWithGoogleImage, generateWithGoogleImagen } from './google.js';
 //# sourceMappingURL=index.js.map

package/dist/image/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/image/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAUH,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAGhD,gEAAgE;AAChE,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/image/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAWH,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAGhD,gEAAgE;AAChE,yEAAyE;AACzE,OAAO,EAAE,uBAAuB,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC"}

package/dist/image/types.d.ts

@@ -22,14 +22,33 @@
  * `image/<provider>.ts` and a branch in `image/client.ts`.
  */
 export type ImageProvider = 'google';
-/** Supported output framings. */
+/**
+ * Supported output framings.
+ *
+ * The Gemini image models accept a wider set than this (the Interactions
+ * API takes `response_format.aspect_ratio`), but this union is
+ * deliberately limited to the four ratios that were verified against the
+ * old Imagen surface and are still exercised by callers. Widen it only
+ * against the published ratio table — an unsupported value is a vendor
+ * 400 at generation time, not a compile error.
+ */
 export type ImageAspectRatio = '1:1' | '4:3' | '16:9' | '9:16';
+/**
+ * Output resolution tier, passed through as
+ * `response_format.image_size`. Omit to take the vendor default (1K).
+ *
+ * Pricing scales with this: at the Nano Banana 2 rate a 1K image is
+ * ~$0.067 and a 4K image ~$0.151, so it is a cost lever, not just a
+ * quality one. Google's pricing table also lists a 0.5K tier whose API
+ * token is not documented alongside these, so it is omitted here.
+ */
+export type ImageOutputSize = '1K' | '2K' | '4K';
 /**
  * A text-to-image request. Provider-neutral on the wire — the adapter
  * translates these fields into its vendor's request shape.
  */
 export interface ImageGenerationRequest {
-    /** Vendor-specific model id (e.g. `'imagen-4.0-ultra-generate-001'`). */
+    /** Vendor-specific model id (e.g. `'gemini-3.1-flash-image'`). */
     model: string;
     /**
      * The full prompt sent to the model. Any brand / style suffix is the
@@ -38,6 +57,8 @@ export interface ImageGenerationRequest {
     prompt: string;
     /** Output framing. Defaults to `'16:9'`. */
     aspectRatio?: ImageAspectRatio;
+    /** Output resolution tier. Defaults to the vendor's own default. */
+    imageSize?: ImageOutputSize;
     /** Number of images to generate. Defaults to `1`. */
     count?: number;
     /**

package/dist/image/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/image/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH;;;;;GAKG;AACH,MAAM,MAAM,aAAa,GAAG,QAAQ,CAAC;AAErC,iCAAiC;AACjC,MAAM,MAAM,gBAAgB,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;AAE/D;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC,yEAAyE;IACzE,KAAK,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAC;IACf,4CAA4C;IAC5C,WAAW,CAAC,EAAE,gBAAgB,CAAC;IAC/B,qDAAqD;IACrD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,2BAA2B;AAC3B,MAAM,WAAW,cAAc;IAC7B,+BAA+B;IAC/B,KAAK,EAAE,UAAU,CAAC;IAClB,6DAA6D;IAC7D,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,4DAA4D;AAC5D,MAAM,WAAW,qBAAqB;IACpC,sEAAsE;IACtE,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,wCAAwC;IACxC,QAAQ,EAAE,aAAa,CAAC;IACxB,6CAA6C;IAC7C,KAAK,EAAE,MAAM,CAAC;IACd,6DAA6D;IAC7D,SAAS,EAAE,MAAM,CAAC;CACnB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/image/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH;;;;;GAKG;AACH,MAAM,MAAM,aAAa,GAAG,QAAQ,CAAC;AAErC;;;;;;;;;GASG;AACH,MAAM,MAAM,gBAAgB,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;AAE/D;;;;;;;;GAQG;AACH,MAAM,MAAM,eAAe,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAEjD;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC,kEAAkE;IAClE,KAAK,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAC;IACf,4CAA4C;IAC5C,WAAW,CAAC,EAAE,gBAAgB,CAAC;IAC/B,oEAAoE;IACpE,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,qDAAqD;IACrD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,2BAA2B;AAC3B,MAAM,WAAW,cAAc;IAC7B,+BAA+B;IAC/B,KAAK,EAAE,UAAU,CAAC;IAClB,6DAA6D;IAC7D,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,4DAA4D;AAC5D,MAAM,WAAW,qBAAqB;IACpC,sEAAsE;IACtE,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,wCAAwC;IACxC,QAAQ,EAAE,aAAa,CAAC;IACxB,6CAA6C;IAC7C,KAAK,EAAE,MAAM,CAAC;IACd,6DAA6D;IAC7D,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@venturekit-pro/ai",
-  "version": "0.0.24",
+  "version": "0.0.25",
   "description": "AI utilities for VentureKit - embeddings, RAG, agents, chat completion, and image generation",
   "type": "module",
   "main": "./dist/index.js",
@@ -37,7 +37,7 @@
     "rag"
   ],
   "dependencies": {
-    "@venturekit/core": "0.0.24"
+    "@venturekit/core": "0.0.25"
   },
   "peerDependencies": {
     "@aws-sdk/client-bedrock-runtime": "^3.0.0",