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

package/dist/model-catalog/crud.js

@@ -0,0 +1,162 @@
+/**
+ * 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.
+ */
+/** List every catalog row, ordered by provider then key. */
+export async function listModels(querier) {
+    return querier(`SELECT * FROM vk_llm_models ORDER BY provider ASC, key ASC`);
+}
+/** Fetch one catalog row by `key` PK, or `null` when absent. */
+export async function getModelByKey(querier, key) {
+    const rows = await querier(`SELECT * FROM vk_llm_models WHERE key = $1 LIMIT 1`, [key]);
+    return rows[0] ?? 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 async function createModel(querier, input) {
+    const status = input.status ?? 'available';
+    const deprecatedAt = status === 'deprecated' ? 'NOW()' : 'NULL';
+    const disabledAt = status === 'disabled' ? 'NOW()' : 'NULL';
+    const rows = await querier(`INSERT INTO vk_llm_models (
+       key, provider, model, display_name, description, status, replacement_key,
+       cost_per_1k_input, cost_per_1k_output,
+       context_window, max_output_tokens,
+       supports_json_mode, supports_image_input,
+       default_max_tokens, default_temperature,
+       tags, notes,
+       deprecated_at, disabled_at
+     ) VALUES (
+       $1, $2, $3, $4, $5, $6::llm_model_status, $7,
+       $8, $9,
+       $10, $11,
+       $12, $13,
+       $14, $15,
+       $16, $17,
+       ${deprecatedAt}, ${disabledAt}
+     )
+     RETURNING *`, [
+        input.key,
+        input.provider,
+        input.model,
+        input.displayName,
+        input.description ?? null,
+        status,
+        input.replacementKey ?? null,
+        input.costPer1kInput ?? null,
+        input.costPer1kOutput ?? null,
+        input.contextWindow ?? null,
+        input.maxOutputTokens ?? null,
+        input.supportsJsonMode ?? false,
+        input.supportsImageInput ?? false,
+        input.defaultMaxTokens ?? 4096,
+        input.defaultTemperature ?? 0.7,
+        input.tags ?? [],
+        input.notes ?? null,
+    ]);
+    const row = rows[0];
+    if (!row)
+        throw new Error('vk_llm_models insert returned no rows');
+    return row;
+}
+/**
+ * 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 async function patchModel(querier, key, input) {
+    const sets = ['updated_at = NOW()'];
+    const params = [];
+    const setField = (col, value, cast) => {
+        params.push(value);
+        sets.push(`${col} = $${params.length}${cast ? `::${cast}` : ''}`);
+    };
+    if (input.provider !== undefined)
+        setField('provider', input.provider);
+    if (input.model !== undefined)
+        setField('model', input.model);
+    if (input.displayName !== undefined)
+        setField('display_name', input.displayName);
+    if (input.description !== undefined)
+        setField('description', input.description);
+    if (input.replacementKey !== undefined)
+        setField('replacement_key', input.replacementKey);
+    if (input.costPer1kInput !== undefined)
+        setField('cost_per_1k_input', input.costPer1kInput);
+    if (input.costPer1kOutput !== undefined)
+        setField('cost_per_1k_output', input.costPer1kOutput);
+    if (input.contextWindow !== undefined)
+        setField('context_window', input.contextWindow);
+    if (input.maxOutputTokens !== undefined)
+        setField('max_output_tokens', input.maxOutputTokens);
+    if (input.supportsJsonMode !== undefined)
+        setField('supports_json_mode', input.supportsJsonMode);
+    if (input.supportsImageInput !== undefined)
+        setField('supports_image_input', input.supportsImageInput);
+    if (input.defaultMaxTokens !== undefined)
+        setField('default_max_tokens', input.defaultMaxTokens);
+    if (input.defaultTemperature !== undefined)
+        setField('default_temperature', input.defaultTemperature);
+    if (input.tags !== undefined)
+        setField('tags', input.tags);
+    if (input.notes !== undefined)
+        setField('notes', input.notes);
+    if (input.status !== undefined) {
+        setField('status', input.status, 'llm_model_status');
+        if (input.status === 'available') {
+            sets.push('deprecated_at = NULL');
+            sets.push('disabled_at = NULL');
+        }
+        else if (input.status === 'deprecated') {
+            sets.push(`deprecated_at = COALESCE((SELECT deprecated_at FROM vk_llm_models WHERE key = $${params.length + 1}), NOW())`);
+            sets.push('disabled_at = NULL');
+        }
+        else if (input.status === 'disabled') {
+            sets.push(`disabled_at = COALESCE((SELECT disabled_at FROM vk_llm_models WHERE key = $${params.length + 1}), NOW())`);
+        }
+    }
+    params.push(key);
+    const sql = `UPDATE vk_llm_models
+                  SET ${sets.join(', ')}
+                WHERE key = $${params.length}
+                RETURNING *`;
+    const rows = await querier(sql, params);
+    return rows[0] ?? null;
+}
+// ─── PG error helpers ───────────────────────────────────────────────
+/** True when `err` is a Postgres `unique_violation` (23505). */
+export function isUniqueViolation(err) {
+    if (err && typeof err === 'object' && 'code' in err) {
+        if (err.code === '23505')
+            return true;
+    }
+    const message = err instanceof Error ? err.message : String(err);
+    return /duplicate key|unique constraint/i.test(message);
+}
+/**
+ * True when `err` is a Postgres `foreign_key_violation` (23503) — the
+ * catalog's only FK is the self-referencing `replacement_key`.
+ */
+export function isForeignKeyViolation(err) {
+    if (err && typeof err === 'object' && 'code' in err) {
+        if (err.code === '23503')
+            return true;
+    }
+    return false;
+}
+//# sourceMappingURL=crud.js.map

package/dist/model-catalog/crud.js.map

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

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

@@ -0,0 +1,11 @@
+/**
+ * `vk_llm_models` catalog — CRUD + types.
+ *
+ * The platform-admin-owned roster of callable models. Pair with the
+ * cost-ledger (`../cost-ledger`) which records actual usage, and with
+ * `createModelCatalog` (`../cost`) which builds the call-time lookup
+ * over `ModelDescriptor`s derived from these rows.
+ */
+export type { LlmModelStatus, LlmModelRow, CreateLlmModelInput, PatchLlmModelInput, Querier, } from './types.js';
+export { listModels, getModelByKey, createModel, patchModel, isUniqueViolation, isForeignKeyViolation, } from './crud.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/model-catalog/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,YAAY,EACV,cAAc,EACd,WAAW,EACX,mBAAmB,EACnB,kBAAkB,EAClB,OAAO,GACR,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,UAAU,EACV,aAAa,EACb,WAAW,EACX,UAAU,EACV,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,WAAW,CAAC"}

package/dist/model-catalog/index.js

@@ -0,0 +1,10 @@
+/**
+ * `vk_llm_models` catalog — CRUD + types.
+ *
+ * The platform-admin-owned roster of callable models. Pair with the
+ * cost-ledger (`../cost-ledger`) which records actual usage, and with
+ * `createModelCatalog` (`../cost`) which builds the call-time lookup
+ * over `ModelDescriptor`s derived from these rows.
+ */
+export { listModels, getModelByKey, createModel, patchModel, isUniqueViolation, isForeignKeyViolation, } from './crud.js';
+//# sourceMappingURL=index.js.map

package/dist/model-catalog/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/model-catalog/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAUH,OAAO,EACL,UAAU,EACV,aAAa,EACb,WAAW,EACX,UAAU,EACV,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,WAAW,CAAC"}

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

@@ -0,0 +1,97 @@
+/**
+ * Types for the `vk_llm_models` catalog CRUD module.
+ *
+ * Sibling of the cost-ledger: the catalog answers "what models can I
+ * call, and what does each cost?" (schema in `vk_ai_cost_0002_llm_models.sql`).
+ * The table is generic — any consumer of `@venturekit-pro/ai` gets the
+ * same shape. Catalog *contents* are an app-level seed concern.
+ *
+ * The row shape mirrors `ModelDescriptor` (see `../cost/types.ts`) but
+ * is wider: it carries the raw NUMERIC pricing/temperature columns (which
+ * `pg` surfaces as strings) and the catalog-only metadata
+ * (`defaultMaxTokens`, `notes`, timestamps) that the descriptor narrows
+ * away for the call-time path.
+ */
+import type { ChatProvider } from '../chat/types.js';
+import type { ModelStatus } from '../cost/types.js';
+/** Lifecycle status — mirrors the DB enum `llm_model_status`. */
+export type LlmModelStatus = ModelStatus;
+/**
+ * One row of `vk_llm_models`, post-mapping (snake_case → camelCase).
+ *
+ * **Numeric columns surface as strings.** `pg` returns Postgres NUMERIC
+ * as strings to preserve precision; the cost-estimator / DTO mappers
+ * `Number()`-convert at their boundaries.
+ */
+export interface LlmModelRow {
+    key: string;
+    provider: ChatProvider;
+    model: string;
+    displayName: string;
+    description: string | null;
+    status: LlmModelStatus;
+    /** When `status='deprecated'`, the catalog `key` of the suggested replacement. */
+    replacementKey: string | null;
+    /** USD per 1K input tokens. Null for experimental / on-prem models. */
+    costPer1kInput: string | null;
+    /** USD per 1K output tokens. Null for experimental / on-prem models. */
+    costPer1kOutput: string | null;
+    contextWindow: number | null;
+    maxOutputTokens: number | null;
+    supportsJsonMode: boolean;
+    supportsImageInput: boolean;
+    defaultMaxTokens: number;
+    /** Stored as numeric(4,3); arrives as a string. */
+    defaultTemperature: string;
+    tags: string[];
+    introducedAt: Date;
+    deprecatedAt: Date | null;
+    disabledAt: Date | null;
+    notes: string | null;
+    createdAt: Date;
+    updatedAt: Date;
+}
+export interface CreateLlmModelInput {
+    key: string;
+    provider: ChatProvider;
+    model: string;
+    displayName: string;
+    description?: string;
+    status?: LlmModelStatus;
+    replacementKey?: string;
+    costPer1kInput?: number;
+    costPer1kOutput?: number;
+    contextWindow?: number;
+    maxOutputTokens?: number;
+    supportsJsonMode?: boolean;
+    supportsImageInput?: boolean;
+    defaultMaxTokens?: number;
+    defaultTemperature?: number;
+    tags?: string[];
+    notes?: string;
+}
+export interface PatchLlmModelInput {
+    provider?: ChatProvider;
+    model?: string;
+    displayName?: string;
+    description?: string | null;
+    status?: LlmModelStatus;
+    replacementKey?: string | null;
+    costPer1kInput?: number | null;
+    costPer1kOutput?: number | null;
+    contextWindow?: number | null;
+    maxOutputTokens?: number | null;
+    supportsJsonMode?: boolean;
+    supportsImageInput?: boolean;
+    defaultMaxTokens?: number;
+    defaultTemperature?: number;
+    tags?: string[];
+    notes?: string | null;
+}
+/**
+ * Querier — same shape as the rest of the workspace. Declared locally so
+ * the module carries no hard dependency on `@venturekit/data`; the
+ * consumer passes their `query` / transaction querier in.
+ */
+export type Querier = <T = Record<string, unknown>[]>(sql: string, params?: unknown[]) => Promise<T>;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/model-catalog/types.ts"],"names":[],"mappings":"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"}

package/dist/model-catalog/types.js

@@ -0,0 +1,16 @@
+/**
+ * Types for the `vk_llm_models` catalog CRUD module.
+ *
+ * Sibling of the cost-ledger: the catalog answers "what models can I
+ * call, and what does each cost?" (schema in `vk_ai_cost_0002_llm_models.sql`).
+ * The table is generic — any consumer of `@venturekit-pro/ai` gets the
+ * same shape. Catalog *contents* are an app-level seed concern.
+ *
+ * The row shape mirrors `ModelDescriptor` (see `../cost/types.ts`) but
+ * is wider: it carries the raw NUMERIC pricing/temperature columns (which
+ * `pg` surfaces as strings) and the catalog-only metadata
+ * (`defaultMaxTokens`, `notes`, timestamps) that the descriptor narrows
+ * away for the call-time path.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/model-catalog/types.js.map

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

package/package.json

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

package/src/cost-ledger/migrations/vk_ai_cost_0001_init.sql

@@ -16,7 +16,7 @@
 
 CREATE EXTENSION IF NOT EXISTS pgcrypto;
 
-CREATE TABLE IF NOT EXISTS llm_cost_events (
+CREATE TABLE IF NOT EXISTS vk_llm_cost_events (
   id              uuid          PRIMARY KEY DEFAULT gen_random_uuid(),
   -- Nullable to match the audit-events convention; platform-wide
   -- LLM calls (e.g. eval / smoke tests) carry tenant_id = NULL.
@@ -56,19 +56,19 @@ CREATE TABLE IF NOT EXISTS llm_cost_events (
 -- ─── Indexes ────────────────────────────────────────────────────────
 
 CREATE INDEX IF NOT EXISTS llm_cost_events_tenant_created_idx
-  ON llm_cost_events (tenant_id, created_at DESC);
+  ON vk_llm_cost_events (tenant_id, created_at DESC);
 
 CREATE INDEX IF NOT EXISTS llm_cost_events_target_idx
-  ON llm_cost_events (tenant_id, target_type, target_id, created_at DESC);
+  ON vk_llm_cost_events (tenant_id, target_type, target_id, created_at DESC);
 
 CREATE INDEX IF NOT EXISTS llm_cost_events_correlation_idx
-  ON llm_cost_events (correlation_id, created_at DESC)
+  ON vk_llm_cost_events (correlation_id, created_at DESC)
   WHERE correlation_id IS NOT NULL;
 
 CREATE INDEX IF NOT EXISTS llm_cost_events_tenant_provider_idx
-  ON llm_cost_events (tenant_id, provider, created_at DESC);
+  ON vk_llm_cost_events (tenant_id, provider, created_at DESC);
 
 -- Idempotency dedup. Partial because most rows have NULL key.
 CREATE UNIQUE INDEX IF NOT EXISTS llm_cost_events_idempotency_unique
-  ON llm_cost_events (idempotency_key)
+  ON vk_llm_cost_events (idempotency_key)
   WHERE idempotency_key IS NOT NULL;

package/src/cost-ledger/migrations/vk_ai_cost_0002_llm_models.sql

@@ -51,7 +51,7 @@ CREATE TYPE llm_model_status AS ENUM (
 
 -- ─── llm_models ────────────────────────────────────────────────────
 
-CREATE TABLE IF NOT EXISTS llm_models (
+CREATE TABLE IF NOT EXISTS vk_llm_models (
   -- Stable catalog id. App-side rows (e.g. `editorial_personas.model`
   -- in the CMS) store THIS, not the vendor's wire id. Lets vendors
   -- rename / replace a SKU without re-stamping every consumer.
@@ -69,7 +69,7 @@ CREATE TABLE IF NOT EXISTS llm_models (
   -- When status='deprecated', the suggested replacement `key`. Used
   -- by the CMS's persona picker to surface "Use <replacement>
   -- instead" nudges (§4.10).
-  replacement_key      varchar(64)        REFERENCES llm_models(key) ON DELETE SET NULL,
+  replacement_key      varchar(64)        REFERENCES vk_llm_models(key) ON DELETE SET NULL,
 
   -- ─── Pricing (USD per 1K tokens) ────────────────────────────────
   -- Nullable for experimental / on-prem models with no published
@@ -116,9 +116,9 @@ CREATE TABLE IF NOT EXISTS llm_models (
 );
 
 CREATE INDEX IF NOT EXISTS llm_models_status_idx
-  ON llm_models (status);
+  ON vk_llm_models (status);
 CREATE INDEX IF NOT EXISTS llm_models_provider_idx
-  ON llm_models (provider);
+  ON vk_llm_models (provider);
 
 -- ─── No seed ───────────────────────────────────────────────────────
 -- Intentionally empty. See file header for the rationale: catalog