@venturekit-pro/ai 0.0.0-dev.20260701100017 → 0.0.1

package/dist/cost-ledger/windows.js

@@ -0,0 +1,147 @@
+/**
+ * Window-based cost rollups over `vk_llm_cost_events`.
+ *
+ * Generic, app-agnostic aggregation for the "cost dashboard" use-case:
+ * pick a trailing window (`7d` / `30d` / `90d` / `ytd`), get KPI totals
+ * + a per-model and per-source breakdown, plus the same totals for the
+ * immediately-prior window so the page can render a period-over-period
+ * delta.
+ *
+ * Distinct from the `query.ts` rollups (which split by `provider` and
+ * return `LlmCostRollup`): this module is keyed on the canonical
+ * `cost_micro_usd` (bigint — safer to SUM than the `cost_usd` numeric)
+ * and surfaces both micro-USD (client math) and USD (display).
+ *
+ * App-specific rollups that JOIN the consumer's own tables (e.g. the
+ * CMS's per-blog-post rollup over `editorial_runs`) stay in the app —
+ * this module only covers the table the package owns.
+ */
+// ─── Window math ───────────────────────────────────────────────────
+/**
+ * Resolve `(current, previous)` ranges for the given key. `now` is
+ * threaded through so callers / tests can pin the clock.
+ *
+ * The `ytd` prior window is the same span last year, ending at "today"
+ * one year ago. Fixed windows (`7d`/`30d`/`90d`) use the immediately
+ * preceding span of equal length.
+ */
+export function computeWindows(key, now = new Date()) {
+    const endedAt = now;
+    let startedAt;
+    let prevStartedAt;
+    let prevEndedAt;
+    if (key === 'ytd') {
+        startedAt = new Date(now.getFullYear(), 0, 1, 0, 0, 0, 0);
+        prevStartedAt = new Date(now.getFullYear() - 1, 0, 1, 0, 0, 0, 0);
+        prevEndedAt = new Date(now.getFullYear() - 1, now.getMonth(), now.getDate(), now.getHours(), now.getMinutes(), now.getSeconds(), 0);
+    }
+    else {
+        const days = key === '7d' ? 7 : key === '30d' ? 30 : key === '90d' ? 90 : 30;
+        const ms = days * 24 * 60 * 60 * 1000;
+        startedAt = new Date(now.getTime() - ms);
+        prevStartedAt = new Date(startedAt.getTime() - ms);
+        prevEndedAt = startedAt;
+    }
+    return {
+        current: {
+            startedAt: startedAt.toISOString(),
+            endedAt: endedAt.toISOString(),
+        },
+        previous: {
+            startedAt: prevStartedAt.toISOString(),
+            endedAt: prevEndedAt.toISOString(),
+        },
+    };
+}
+async function sumTotals(querier, tenantId, window) {
+    const rows = await querier(`SELECT
+       COUNT(*)::text                          AS "callCount",
+       COALESCE(SUM(cost_micro_usd), 0)::text  AS "costMicroUsd",
+       COALESCE(SUM(tokens_in), 0)::text       AS "tokensIn",
+       COALESCE(SUM(tokens_out), 0)::text      AS "tokensOut"
+     FROM vk_llm_cost_events
+     WHERE tenant_id = $1
+       AND created_at >= $2
+       AND created_at <  $3`, [tenantId, window.startedAt, window.endedAt]);
+    const row = rows[0];
+    const costMicroUsd = Number(row.costMicroUsd ?? 0);
+    return {
+        calls: Number(row.callCount ?? 0),
+        costMicroUsd,
+        costUsd: costMicroUsd / 1_000_000,
+        tokensIn: Number(row.tokensIn ?? 0),
+        tokensOut: Number(row.tokensOut ?? 0),
+    };
+}
+async function groupByModel(querier, tenantId, window) {
+    const rows = await querier(`SELECT
+       provider,
+       model,
+       COUNT(*)::text                          AS "callCount",
+       COALESCE(SUM(cost_micro_usd), 0)::text  AS "costMicroUsd",
+       COALESCE(SUM(tokens_in), 0)::text       AS "tokensIn",
+       COALESCE(SUM(tokens_out), 0)::text      AS "tokensOut"
+     FROM vk_llm_cost_events
+     WHERE tenant_id = $1
+       AND created_at >= $2
+       AND created_at <  $3
+     GROUP BY provider, model
+     ORDER BY SUM(cost_micro_usd) DESC NULLS LAST, provider, model`, [tenantId, window.startedAt, window.endedAt]);
+    return rows.map((r) => {
+        const costMicroUsd = Number(r.costMicroUsd ?? 0);
+        return {
+            provider: r.provider,
+            model: r.model,
+            calls: Number(r.callCount ?? 0),
+            costMicroUsd,
+            costUsd: costMicroUsd / 1_000_000,
+            tokensIn: Number(r.tokensIn ?? 0),
+            tokensOut: Number(r.tokensOut ?? 0),
+        };
+    });
+}
+async function groupBySource(querier, tenantId, window) {
+    const rows = await querier(`SELECT
+       source,
+       COUNT(*)::text                          AS "callCount",
+       COALESCE(SUM(cost_micro_usd), 0)::text  AS "costMicroUsd"
+     FROM vk_llm_cost_events
+     WHERE tenant_id = $1
+       AND created_at >= $2
+       AND created_at <  $3
+     GROUP BY source
+     ORDER BY SUM(cost_micro_usd) DESC NULLS LAST, source`, [tenantId, window.startedAt, window.endedAt]);
+    return rows.map((r) => {
+        const costMicroUsd = Number(r.costMicroUsd ?? 0);
+        return {
+            source: r.source,
+            calls: Number(r.callCount ?? 0),
+            costMicroUsd,
+            costUsd: costMicroUsd / 1_000_000,
+        };
+    });
+}
+/**
+ * Roll up costs for one tenant over the given window. Issues four
+ * parallel queries (totals, prev totals, byModel, bySource) and combines
+ * them into a single dashboard DTO. Empty windows return zeros (not
+ * NULLs) so callers can do delta math without null-guarding.
+ */
+export async function rollupCostWindow(querier, args) {
+    const { current, previous } = computeWindows(args.windowKey, args.now ?? new Date());
+    const [totals, prevTotals, byModel, bySource] = await Promise.all([
+        sumTotals(querier, args.tenantId, current),
+        sumTotals(querier, args.tenantId, previous),
+        groupByModel(querier, args.tenantId, current),
+        groupBySource(querier, args.tenantId, current),
+    ]);
+    return {
+        window: current,
+        prevWindow: previous,
+        totals,
+        prevTotals,
+        byModel,
+        bySource,
+    };
+}
+//# sourceMappingURL=windows.js.map

package/dist/cost-ledger/windows.js.map

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

package/dist/image/client.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Image generation client — provider-neutral entry point, mirroring
+ * `chat/client.ts`.
+ *
+ * Construct one client per (provider, apiKey) via `createImageClient()`
+ * and call `.generate()` against it. The factory switches on `provider`
+ * once, at construction.
+ */
+import type { ImageGenerationRequest, ImageGenerationResult, ImageProvider } from './types.js';
+import { type GoogleImageAdapterConfig } from './google.js';
+/**
+ * Minimal interface for image generation. Implementations are
+ * per-provider thin wrappers that hold the API key + base URL + timeout
+ * and translate to the vendor's REST shape.
+ */
+export interface ImageGenerationClient {
+    readonly provider: ImageProvider;
+    generate(request: ImageGenerationRequest): Promise<ImageGenerationResult>;
+}
+/**
+ * Construct-time configuration, discriminated by `provider` so more
+ * vendors can be added without widening the others' option bags.
+ */
+export type ImageClientConfig = {
+    provider: 'google';
+} & GoogleImageAdapterConfig;
+/**
+ * Build an image client. Throws synchronously on an unknown provider so
+ * the caller fails fast rather than at the first `.generate()` call.
+ */
+export declare function createImageClient(config: ImageClientConfig): ImageGenerationClient;
+//# sourceMappingURL=client.d.ts.map

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

@@ -0,0 +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"}

package/dist/image/client.js

@@ -0,0 +1,25 @@
+/**
+ * Image generation client — provider-neutral entry point, mirroring
+ * `chat/client.ts`.
+ *
+ * Construct one client per (provider, apiKey) via `createImageClient()`
+ * and call `.generate()` against it. The factory switches on `provider`
+ * once, at construction.
+ */
+import { generateWithGoogleImagen } 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.
+ */
+export function createImageClient(config) {
+    if (config.provider !== 'google') {
+        throw new Error(`[ai/image] Unsupported provider: ${String(config.provider)}`);
+    }
+    const { provider: _ignored, ...adapterConfig } = config;
+    void _ignored;
+    return {
+        provider: 'google',
+        generate: (request) => generateWithGoogleImagen(adapterConfig, request),
+    };
+}
+//# sourceMappingURL=client.js.map

package/dist/image/client.js.map

@@ -0,0 +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"}

package/dist/image/google.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Google Imagen adapter (Generative Language REST API).
+ *
+ * Talks to the `:generate` endpoint on
+ * `generativelanguage.googleapis.com` — the same surface the CMS media
+ * pipeline used before this module existed, lifted here verbatim so the
+ * swap is behavior-preserving. Imagen returns one image per call, so we
+ * loop `count` times and collect the bytes.
+ *
+ * Auth is via the `?key=` query param (the documented REST form for
+ * Generative Language API keys), escaped through `encodeURIComponent`.
+ */
+import type { ImageGenerationRequest, ImageGenerationResult } from './types.js';
+export interface GoogleImageAdapterConfig {
+    apiKey: string;
+    /** Override the API host. Defaults to `https://generativelanguage.googleapis.com`. */
+    baseUrl?: string;
+    /** API version. Defaults to `v1beta`. */
+    apiVersion?: string;
+    /** Request timeout in milliseconds. Default 120s — image gen is slow. */
+    timeoutMs?: number;
+}
+export declare function generateWithGoogleImagen(config: GoogleImageAdapterConfig, request: ImageGenerationRequest): Promise<ImageGenerationResult>;
+//# sourceMappingURL=google.d.ts.map

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

@@ -0,0 +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,CAyDhC"}

package/dist/image/google.js

@@ -0,0 +1,60 @@
+/**
+ * Google Imagen adapter (Generative Language REST API).
+ *
+ * Talks to the `:generate` endpoint on
+ * `generativelanguage.googleapis.com` — the same surface the CMS media
+ * pipeline used before this module existed, lifted here verbatim so the
+ * swap is behavior-preserving. Imagen returns one image per call, so we
+ * loop `count` times and collect the bytes.
+ *
+ * Auth is via the `?key=` query param (the documented REST form for
+ * Generative Language API keys), escaped through `encodeURIComponent`.
+ */
+export async function generateWithGoogleImagen(config, request) {
+    const startedAt = Date.now();
+    const baseUrl = (config.baseUrl ?? 'https://generativelanguage.googleapis.com').replace(/\/+$/, '');
+    const apiVersion = config.apiVersion ?? 'v1beta';
+    const timeoutMs = request.timeoutMs ?? config.timeoutMs ?? 120_000;
+    // At least one image; the caller (e.g. the CMS media route) owns any
+    // 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)}:generate?key=${encodeURIComponent(config.apiKey)}`;
+    const images = [];
+    for (let i = 0; i < count; i++) {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), timeoutMs);
+        let response;
+        try {
+            response = await fetch(url, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({ prompt: request.prompt, aspectRatio }),
+                signal: controller.signal,
+            });
+        }
+        finally {
+            clearTimeout(timer);
+        }
+        if (!response.ok) {
+            const text = (await response.text()).slice(0, 500);
+            throw new Error(`[ai/image/google] ${response.status} ${response.statusText}: ${text}`);
+        }
+        const json = (await response.json());
+        const im = json.images?.[0];
+        if (!im?.bytesBase64Encoded) {
+            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',
+        });
+    }
+    return {
+        images,
+        provider: 'google',
+        model: request.model,
+        latencyMs: Date.now() - startedAt,
+    };
+}
+//# sourceMappingURL=google.js.map

package/dist/image/google.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"google.js","sourceRoot":"","sources":["../../src/image/google.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAsBH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,MAAgC,EAChC,OAA+B;IAE/B,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7B,MAAM,OAAO,GAAG,CAAC,MAAM,CAAC,OAAO,IAAI,2CAA2C,CAAC,CAAC,OAAO,CACrF,MAAM,EACN,EAAE,CACH,CAAC;IACF,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,IAAI,QAAQ,CAAC;IACjD,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,MAAM,CAAC,SAAS,IAAI,OAAO,CAAC;IACnE,qEAAqE;IACrE,sCAAsC;IACtC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC;IAC9C,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,MAAM,CAAC;IAElD,MAAM,GAAG,GAAG,GAAG,OAAO,IAAI,UAAU,WAAW,kBAAkB,CAC/D,OAAO,CAAC,KAAK,CACd,iBAAiB,kBAAkB,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;IAEtD,MAAM,MAAM,GAAqB,EAAE,CAAC;IACpC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;QAC/B,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,SAAS,CAAC,CAAC;QAC9D,IAAI,QAAkB,CAAC;QACvB,IAAI,CAAC;YACH,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;gBAC1B,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;gBAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC;gBAC7D,MAAM,EAAE,UAAU,CAAC,MAAM;aAC1B,CAAC,CAAC;QACL,CAAC;gBAAS,CAAC;YACT,YAAY,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC;QAED,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;YACnD,MAAM,IAAI,KAAK,CACb,qBAAqB,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,KAAK,IAAI,EAAE,CACvE,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAA2B,CAAC;QAC/D,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC;QAC5B,IAAI,CAAC,EAAE,EAAE,kBAAkB,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;QAC/D,CAAC;QACD,MAAM,CAAC,IAAI,CAAC;YACV,KAAK,EAAE,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,kBAAkB,EAAE,QAAQ,CAAC,CAAC;YACpE,QAAQ,EAAE,EAAE,CAAC,QAAQ,IAAI,WAAW;SACrC,CAAC,CAAC;IACL,CAAC;IAED,OAAO;QACL,MAAM;QACN,QAAQ,EAAE,QAAQ;QAClB,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;KAClC,CAAC;AACJ,CAAC"}

package/dist/image/index.d.ts

@@ -0,0 +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).
+ */
+export type { ImageProvider, ImageAspectRatio, ImageGenerationRequest, ImageGenerationResult, GeneratedImage, } from './types.js';
+export { createImageClient } from './client.js';
+export type { ImageGenerationClient, ImageClientConfig } from './client.js';
+export { generateWithGoogleImagen } from './google.js';
+export type { GoogleImageAdapterConfig } from './google.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +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"}

package/dist/image/index.js

@@ -0,0 +1,9 @@
+/**
+ * Image generation — provider-neutral text-to-image with raw byte
+ * output. Currently Google Imagen; 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';
+//# sourceMappingURL=index.js.map

package/dist/image/index.js.map

@@ -0,0 +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"}

package/dist/image/types.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Image generation types.
+ *
+ * Provider-neutral text-to-image generation, mirroring `chat/` in
+ * shape: the request carries the model + prompt + framing options, the
+ * result carries the raw image bytes plus a provider / model echo for
+ * audit trails.
+ *
+ * Cost is intentionally NOT stamped here. Image vendors price
+ * per-image (not per-token) and the per-image rate isn't carried on the
+ * request, so cost attribution is left to the caller's cost ledger —
+ * unlike `chat/` where token usage makes an inline stamp natural.
+ *
+ * Tool use, inpainting / editing, and reference-image conditioning are
+ * explicit non-goals for this first cut — it covers the single
+ * text→image call the CMS media pipeline needs.
+ */
+/**
+ * The vendor whose HTTP API an image client is wired to.
+ *
+ * Adding a value requires a corresponding adapter file under
+ * `image/<provider>.ts` and a branch in `image/client.ts`.
+ */
+export type ImageProvider = 'google';
+/** Supported output framings. */
+export type ImageAspectRatio = '1:1' | '4:3' | '16:9' | '9:16';
+/**
+ * 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'`). */
+    model: string;
+    /**
+     * The full prompt sent to the model. Any brand / style suffix is the
+     * caller's concern — fold it in before calling.
+     */
+    prompt: string;
+    /** Output framing. Defaults to `'16:9'`. */
+    aspectRatio?: ImageAspectRatio;
+    /** Number of images to generate. Defaults to `1`. */
+    count?: number;
+    /**
+     * Per-request timeout in milliseconds. Falls back to the client's
+     * configured `timeoutMs`.
+     */
+    timeoutMs?: number;
+}
+/** One generated image. */
+export interface GeneratedImage {
+    /** Raw decoded image bytes. */
+    bytes: Uint8Array;
+    /** MIME type reported by the vendor (e.g. `'image/png'`). */
+    mimeType: string;
+}
+/** Result of an image generation call. Provider-neutral. */
+export interface ImageGenerationResult {
+    /** The generated images, in request order. Length matches `count`. */
+    images: GeneratedImage[];
+    /** Provider that served the request. */
+    provider: ImageProvider;
+    /** Model id echoed back for audit trails. */
+    model: string;
+    /** Wall-clock latency across all images, in milliseconds. */
+    latencyMs: number;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +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"}

package/dist/image/types.js

@@ -0,0 +1,19 @@
+/**
+ * Image generation types.
+ *
+ * Provider-neutral text-to-image generation, mirroring `chat/` in
+ * shape: the request carries the model + prompt + framing options, the
+ * result carries the raw image bytes plus a provider / model echo for
+ * audit trails.
+ *
+ * Cost is intentionally NOT stamped here. Image vendors price
+ * per-image (not per-token) and the per-image rate isn't carried on the
+ * request, so cost attribution is left to the caller's cost ledger —
+ * unlike `chat/` where token usage makes an inline stamp natural.
+ *
+ * Tool use, inpainting / editing, and reference-image conditioning are
+ * explicit non-goals for this first cut — it covers the single
+ * text→image call the CMS media pipeline needs.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/image/types.js.map

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

package/dist/index.d.ts

@@ -20,12 +20,16 @@ export { buildContextPrompt, tenantFilter, createContextAwareAgent, createContex
 export type { VentureKitAIContext, PermissionCheck, ContextAwareAgentOptions, ContextAwareRagOptions, } from './context/context.js';
 export { createChatClient, completeWithAnthropic, completeWithOpenAi, completeWithGoogle, stampCost, round8, } from './chat/index.js';
 export type { ChatProvider, ChatMessage, ChatModelPricing, ChatCompletionRequest, ChatCompletionResult, ChatTokenUsage, ChatFinishReason, CostStamp, ChatCompletionClient, ChatClientConfig, AnthropicAdapterConfig, OpenAiAdapterConfig, GoogleAdapterConfig, } from './chat/index.js';
+export { createImageClient, generateWithGoogleImagen } from './image/index.js';
+export type { ImageProvider, ImageAspectRatio, ImageGenerationRequest, ImageGenerationResult, GeneratedImage, ImageGenerationClient, ImageClientConfig, GoogleImageAdapterConfig, } from './image/index.js';
 export { estimateTokens, estimateCost, estimateCostForModel, createModelCatalog, } from './cost/index.js';
 export type { ModelDescriptor, ModelStatus, ModelCatalog, CostEstimate, CostEstimateInput, } from './cost/index.js';
 export { renderTemplate, renderPromptTemplate, promptContentHash, } from './prompts/index.js';
 export type { PromptTemplate, PromptVariable, RenderResult, } from './prompts/index.js';
 export { retryWithBackoff, isRetryableError, withFallback, } from './fallback/index.js';
 export type { RetryOptions, FallbackOptions } from './fallback/index.js';
-export { recordLlmCost, listLlmCosts, costByTarget as llmCostByTarget, costByCorrelation as llmCostByCorrelation, costByTenant as llmCostByTenant, costByMonth as llmCostByMonth, getAiCostMigrationsDir, } from './cost-ledger/index.js';
-export type { LlmCostInput, LlmCostEvent, LlmCostRollup, ListLlmCostsArgs, CostByTargetArgs as LlmCostByTargetArgs, CostByCorrelationArgs as LlmCostByCorrelationArgs, CostByTenantArgs as LlmCostByTenantArgs, CostByMonthArgs as LlmCostByMonthArgs, MonthlyCostBucket as LlmMonthlyCostBucket, } from './cost-ledger/index.js';
+export { recordLlmCost, listLlmCosts, costByTarget as llmCostByTarget, costByCorrelation as llmCostByCorrelation, costByTenant as llmCostByTenant, costByMonth as llmCostByMonth, computeWindows, rollupCostWindow, getAiCostMigrationsDir, } from './cost-ledger/index.js';
+export type { LlmCostInput, LlmCostEvent, LlmCostRollup, ListLlmCostsArgs, CostByTargetArgs as LlmCostByTargetArgs, CostByCorrelationArgs as LlmCostByCorrelationArgs, CostByTenantArgs as LlmCostByTenantArgs, CostByMonthArgs as LlmCostByMonthArgs, MonthlyCostBucket as LlmMonthlyCostBucket, CostWindowKey, CostWindowRange, CostTotals, CostByModelRow, CostBySourceRow, CostRollupResult, RollupCostWindowArgs, } from './cost-ledger/index.js';
+export { listModels, getModelByKey, createModel, patchModel, isUniqueViolation as isLlmModelUniqueViolation, isForeignKeyViolation as isLlmModelForeignKeyViolation, } from './model-catalog/index.js';
+export type { LlmModelStatus, LlmModelRow, CreateLlmModelInput, PatchLlmModelInput, } from './model-catalog/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,cAAc,kBAAkB,CAAC;AAGjC,OAAO,EACL,qBAAqB,EACrB,wBAAwB,EACxB,cAAc,GACf,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAGtD,OAAO,EACL,uBAAuB,EACvB,2BAA2B,EAC3B,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGtD,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,iBAAiB,EACjB,SAAS,GACV,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAGlD,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,WAAW,EACX,UAAU,GACX,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAG/C,OAAO,EACL,kBAAkB,EAClB,YAAY,EACZ,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,mBAAmB,EACnB,eAAe,EACf,wBAAwB,EACxB,sBAAsB,GACvB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,gBAAgB,EAChB,qBAAqB,EACrB,kBAAkB,EAClB,kBAAkB,EAClB,SAAS,EACT,MAAM,GACP,MAAM,iBAAiB,CAAC;AACzB,YAAY,EACV,YAAY,EACZ,WAAW,EACX,gBAAgB,EAChB,qBAAqB,EACrB,oBAAoB,EACpB,cAAc,EACd,gBAAgB,EAChB,SAAS,EACT,oBAAoB,EACpB,gBAAgB,EAChB,sBAAsB,EACtB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,cAAc,EACd,YAAY,EACZ,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EACV,eAAe,EACf,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,iBAAiB,GAClB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,cAAc,EACd,cAAc,EACd,YAAY,GACb,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,GACb,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAGzE,OAAO,EACL,aAAa,EACb,YAAY,EACZ,YAAY,IAAI,eAAe,EAC/B,iBAAiB,IAAI,oBAAoB,EACzC,YAAY,IAAI,eAAe,EAC/B,WAAW,IAAI,cAAc,EAC7B,sBAAsB,GACvB,MAAM,wBAAwB,CAAC;AAChC,YAAY,EACV,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,gBAAgB,IAAI,mBAAmB,EACvC,qBAAqB,IAAI,wBAAwB,EACjD,gBAAgB,IAAI,mBAAmB,EACvC,eAAe,IAAI,kBAAkB,EACrC,iBAAiB,IAAI,oBAAoB,GAC1C,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -21,6 +21,8 @@ export { createAgentConfig, DEFAULT_AGENT_CONFIG, createAgent, defineTool, } fro
 export { buildContextPrompt, tenantFilter, createContextAwareAgent, createContextAwareRag, } from './context/context.js';
 // Chat completion (single-turn / multi-turn, no tool-use)
 export { createChatClient, completeWithAnthropic, completeWithOpenAi, completeWithGoogle, stampCost, round8, } from './chat/index.js';
+// Image generation (text-to-image, raw bytes)
+export { createImageClient, generateWithGoogleImagen } from './image/index.js';
 // Model catalog + cost estimation
 export { estimateTokens, estimateCost, estimateCostForModel, createModelCatalog, } from './cost/index.js';
 // Prompt templates
@@ -28,5 +30,7 @@ export { renderTemplate, renderPromptTemplate, promptContentHash, } from './prom
 // Retry + primary→backup fallback
 export { retryWithBackoff, isRetryableError, withFallback, } from './fallback/index.js';
 // LLM cost ledger (llm_cost_events table + record/query helpers)
-export { recordLlmCost, listLlmCosts, costByTarget as llmCostByTarget, costByCorrelation as llmCostByCorrelation, costByTenant as llmCostByTenant, costByMonth as llmCostByMonth, getAiCostMigrationsDir, } from './cost-ledger/index.js';
+export { recordLlmCost, listLlmCosts, costByTarget as llmCostByTarget, costByCorrelation as llmCostByCorrelation, costByTenant as llmCostByTenant, costByMonth as llmCostByMonth, computeWindows, rollupCostWindow, getAiCostMigrationsDir, } from './cost-ledger/index.js';
+// LLM model catalog (vk_llm_models table CRUD)
+export { listModels, getModelByKey, createModel, patchModel, isUniqueViolation as isLlmModelUniqueViolation, isForeignKeyViolation as isLlmModelForeignKeyViolation, } from './model-catalog/index.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,yDAAyD;AACzD,cAAc,kBAAkB,CAAC;AAEjC,aAAa;AACb,OAAO,EACL,qBAAqB,EACrB,wBAAwB,EACxB,cAAc,GACf,MAAM,uBAAuB,CAAC;AAG/B,eAAe;AACf,OAAO,EACL,uBAAuB,EACvB,2BAA2B,EAC3B,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAG5B,MAAM;AACN,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,iBAAiB,EACjB,SAAS,GACV,MAAM,gBAAgB,CAAC;AAGxB,yBAAyB;AACzB,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,WAAW,EACX,UAAU,GACX,MAAM,mBAAmB,CAAC;AAG3B,8CAA8C;AAC9C,OAAO,EACL,kBAAkB,EAClB,YAAY,EACZ,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,sBAAsB,CAAC;AAQ9B,0DAA0D;AAC1D,OAAO,EACL,gBAAgB,EAChB,qBAAqB,EACrB,kBAAkB,EAClB,kBAAkB,EAClB,SAAS,EACT,MAAM,GACP,MAAM,iBAAiB,CAAC;AAiBzB,kCAAkC;AAClC,OAAO,EACL,cAAc,EACd,YAAY,EACZ,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,iBAAiB,CAAC;AASzB,mBAAmB;AACnB,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAO5B,kCAAkC;AAClC,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,GACb,MAAM,qBAAqB,CAAC;AAG7B,iEAAiE;AACjE,OAAO,EACL,aAAa,EACb,YAAY,EACZ,YAAY,IAAI,eAAe,EAC/B,iBAAiB,IAAI,oBAAoB,EACzC,YAAY,IAAI,eAAe,EAC/B,WAAW,IAAI,cAAc,EAC7B,sBAAsB,GACvB,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,yDAAyD;AACzD,cAAc,kBAAkB,CAAC;AAEjC,aAAa;AACb,OAAO,EACL,qBAAqB,EACrB,wBAAwB,EACxB,cAAc,GACf,MAAM,uBAAuB,CAAC;AAG/B,eAAe;AACf,OAAO,EACL,uBAAuB,EACvB,2BAA2B,EAC3B,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAG5B,MAAM;AACN,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,iBAAiB,EACjB,SAAS,GACV,MAAM,gBAAgB,CAAC;AAGxB,yBAAyB;AACzB,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,WAAW,EACX,UAAU,GACX,MAAM,mBAAmB,CAAC;AAG3B,8CAA8C;AAC9C,OAAO,EACL,kBAAkB,EAClB,YAAY,EACZ,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,sBAAsB,CAAC;AAQ9B,0DAA0D;AAC1D,OAAO,EACL,gBAAgB,EAChB,qBAAqB,EACrB,kBAAkB,EAClB,kBAAkB,EAClB,SAAS,EACT,MAAM,GACP,MAAM,iBAAiB,CAAC;AAiBzB,8CAA8C;AAC9C,OAAO,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAY/E,kCAAkC;AAClC,OAAO,EACL,cAAc,EACd,YAAY,EACZ,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,iBAAiB,CAAC;AASzB,mBAAmB;AACnB,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAO5B,kCAAkC;AAClC,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,GACb,MAAM,qBAAqB,CAAC;AAG7B,iEAAiE;AACjE,OAAO,EACL,aAAa,EACb,YAAY,EACZ,YAAY,IAAI,eAAe,EAC/B,iBAAiB,IAAI,oBAAoB,EACzC,YAAY,IAAI,eAAe,EAC/B,WAAW,IAAI,cAAc,EAC7B,cAAc,EACd,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,wBAAwB,CAAC;AAoBhC,+CAA+C;AAC/C,OAAO,EACL,UAAU,EACV,aAAa,EACb,WAAW,EACX,UAAU,EACV,iBAAiB,IAAI,yBAAyB,EAC9C,qBAAqB,IAAI,6BAA6B,GACvD,MAAM,0BAA0B,CAAC"}

package/dist/model-catalog/crud.d.ts

@@ -0,0 +1,42 @@
+/**
+ * CRUD over `vk_llm_models` — the model catalog.
+ *
+ * Pure SQL against a caller-supplied `Querier`; no `@venturekit/data`
+ * import (the consumer passes their `query` / transaction querier).
+ *
+ * Lifecycle timestamps are auto-managed on `status` transitions and the
+ * DB enforces `llm_models_status_timestamps_chk` so a `deprecated` /
+ * `disabled` row always has its matching timestamp. The `key` PK and the
+ * `(provider, model)` unique constraint are DB-enforced — callers map
+ * `23505` to a 409 via `isUniqueViolation`. The self-referencing
+ * `replacement_key` FK trips `23503` when it names a non-existent key.
+ */
+import type { CreateLlmModelInput, LlmModelRow, PatchLlmModelInput, Querier } from './types.js';
+/** List every catalog row, ordered by provider then key. */
+export declare function listModels(querier: Querier): Promise<LlmModelRow[]>;
+/** Fetch one catalog row by `key` PK, or `null` when absent. */
+export declare function getModelByKey(querier: Querier, key: string): Promise<LlmModelRow | null>;
+/**
+ * Insert a new catalog row. When created already in a `deprecated` /
+ * `disabled` state the matching lifecycle timestamp is auto-stamped to
+ * `NOW()` so the happy path stays one-shot (and satisfies the DB CHECK).
+ */
+export declare function createModel(querier: Querier, input: CreateLlmModelInput): Promise<LlmModelRow>;
+/**
+ * Patch a catalog row. Returns `null` when the row doesn't exist.
+ *
+ * Status transitions auto-stamp / auto-clear the lifecycle timestamps:
+ *   - `available`  — clears both `deprecated_at` + `disabled_at`.
+ *   - `deprecated` — sets `deprecated_at` (COALESCE preserves the
+ *     original transition time across no-op repeats), clears `disabled_at`.
+ *   - `disabled`   — sets `disabled_at` (same COALESCE preservation).
+ */
+export declare function patchModel(querier: Querier, key: string, input: PatchLlmModelInput): Promise<LlmModelRow | null>;
+/** True when `err` is a Postgres `unique_violation` (23505). */
+export declare function isUniqueViolation(err: unknown): boolean;
+/**
+ * True when `err` is a Postgres `foreign_key_violation` (23503) — the
+ * catalog's only FK is the self-referencing `replacement_key`.
+ */
+export declare function isForeignKeyViolation(err: unknown): boolean;
+//# sourceMappingURL=crud.d.ts.map

package/dist/model-catalog/crud.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crud.d.ts","sourceRoot":"","sources":["../../src/model-catalog/crud.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EACV,mBAAmB,EACnB,WAAW,EACX,kBAAkB,EAClB,OAAO,EACR,MAAM,YAAY,CAAC;AAEpB,4DAA4D;AAC5D,wBAAsB,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAIzE;AAED,gEAAgE;AAChE,wBAAsB,aAAa,CACjC,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAM7B;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAC/B,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,mBAAmB,GACzB,OAAO,CAAC,WAAW,CAAC,CA+CtB;AAED;;;;;;;;GAQG;AACH,wBAAsB,UAAU,CAC9B,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,kBAAkB,GACxB,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAiD7B;AAID,gEAAgE;AAChE,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAMvD;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAK3D"}