@prenta/core 0.118.0

package/dist/ai/sampling.js

@@ -0,0 +1,51 @@
+/**
+ * Sampling-parameter policy for provider model calls.
+ *
+ * Some reasoning models (Anthropic Opus 4.7+, OpenAI o-series, catalog entries
+ * flagged `reasoning: true`) reject `temperature` / `top_p` / `top_k`. The
+ * runtime omits those fields rather than failing at the provider.
+ */
+/** Provider-native ids that reject sampling params even without curated metadata. */
+export function providerModelIdDisallowsSampling(providerModelId) {
+    const id = providerModelId.toLowerCase();
+    // Anthropic Opus 4.7 generation and later.
+    if (/^claude-opus-4-(?:7|[89]|\d{2,})/.test(id))
+        return true;
+    // OpenAI reasoning / o-series models.
+    if (/^o[0-9]/.test(id))
+        return true;
+    return false;
+}
+/** Whether a resolved model should not receive temperature / top_p / top_k. */
+export function modelDisallowsSampling(providerModelId, capabilities) {
+    if (capabilities?.reasoning)
+        return true;
+    return providerModelIdDisallowsSampling(providerModelId);
+}
+/** Return temperature only when the model accepts sampling parameters. */
+export function resolveTemperatureForModel(providerModelId, capabilities, temperature) {
+    if (typeof temperature !== 'number')
+        return undefined;
+    if (modelDisallowsSampling(providerModelId, capabilities))
+        return undefined;
+    return temperature;
+}
+const SAMPLING_PARAM_HINT = 'The selected model does not support temperature. Choose a non-reasoning text model (e.g. Claude Sonnet) in Settings > AI.';
+/** Map provider sampling rejections to an actionable admin message. */
+export function samplingParamProviderMessage(providerMessage) {
+    const lower = providerMessage.toLowerCase();
+    if (lower.includes('temperature') &&
+        (lower.includes('deprecated') ||
+            lower.includes('not support') ||
+            lower.includes('unsupported') ||
+            lower.includes('invalid') ||
+            lower.includes('removed'))) {
+        return SAMPLING_PARAM_HINT;
+    }
+    if ((lower.includes('top_p') || lower.includes('top_k')) &&
+        (lower.includes('not support') || lower.includes('unsupported') || lower.includes('invalid'))) {
+        return SAMPLING_PARAM_HINT;
+    }
+    return undefined;
+}
+//# sourceMappingURL=sampling.js.map

package/dist/ai/sampling.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sampling.js","sourceRoot":"","sources":["../../src/ai/sampling.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,qFAAqF;AACrF,MAAM,UAAU,gCAAgC,CAAC,eAAuB;IACtE,MAAM,EAAE,GAAG,eAAe,CAAC,WAAW,EAAE,CAAA;IAExC,2CAA2C;IAC3C,IAAI,kCAAkC,CAAC,IAAI,CAAC,EAAE,CAAC;QAAE,OAAO,IAAI,CAAA;IAE5D,sCAAsC;IACtC,IAAI,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;QAAE,OAAO,IAAI,CAAA;IAEnC,OAAO,KAAK,CAAA;AACd,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,sBAAsB,CACpC,eAAuB,EACvB,YAA2C;IAE3C,IAAI,YAAY,EAAE,SAAS;QAAE,OAAO,IAAI,CAAA;IACxC,OAAO,gCAAgC,CAAC,eAAe,CAAC,CAAA;AAC1D,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,0BAA0B,CACxC,eAAuB,EACvB,YAAsD,EACtD,WAA+B;IAE/B,IAAI,OAAO,WAAW,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAA;IACrD,IAAI,sBAAsB,CAAC,eAAe,EAAE,YAAY,CAAC;QAAE,OAAO,SAAS,CAAA;IAC3E,OAAO,WAAW,CAAA;AACpB,CAAC;AAED,MAAM,mBAAmB,GACvB,2HAA2H,CAAA;AAE7H,uEAAuE;AACvE,MAAM,UAAU,4BAA4B,CAAC,eAAuB;IAClE,MAAM,KAAK,GAAG,eAAe,CAAC,WAAW,EAAE,CAAA;IAC3C,IACE,KAAK,CAAC,QAAQ,CAAC,aAAa,CAAC;QAC7B,CAAC,KAAK,CAAC,QAAQ,CAAC,YAAY,CAAC;YAC3B,KAAK,CAAC,QAAQ,CAAC,aAAa,CAAC;YAC7B,KAAK,CAAC,QAAQ,CAAC,aAAa,CAAC;YAC7B,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC;YACzB,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,EAC5B,CAAC;QACD,OAAO,mBAAmB,CAAA;IAC5B,CAAC;IACD,IACE,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QACpD,CAAC,KAAK,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,EAC7F,CAAC;QACD,OAAO,mBAAmB,CAAA;IAC5B,CAAC;IACD,OAAO,SAAS,CAAA;AAClB,CAAC"}

package/dist/ai/types.d.ts

@@ -0,0 +1,193 @@
+/**
+ * Shared types for the Settings > AI governance layer.
+ *
+ * Phases 1-2 cover provider connections (encrypted keys) and a dynamic,
+ * normalized model catalog. Feature config, budget, and data-policy shapes are
+ * declared here for forward-compatibility (enforcement + metering land in later
+ * phases) but only `features[].enabled` and `budget.monthlyTokenLimit` are
+ * wired into the UI for now.
+ */
+/** Provider keys are stable code identifiers. `openai` covers OpenAI/ChatGPT. */
+export type AIProviderKey = 'openai' | 'anthropic' | 'xai' | 'custom';
+/** Where a provider's API key actually comes from at runtime. */
+export type AIKeySource = 'environment' | 'database' | 'config';
+/** Connection health surfaced in the UI (always rendered as text, not color-only). */
+export type AIConnectionStatus = 'connected' | 'invalid_key' | 'rate_limited' | 'provider_down' | 'needs_setup' | 'unknown';
+/** Availability of a catalog model relative to the connected account. */
+export type AIModelStatus = 'available' | 'unavailable' | 'deprecated' | 'unknown';
+export interface AIModelCapabilities {
+    text: boolean;
+    vision: boolean;
+    imageGeneration: boolean;
+    embeddings: boolean;
+    toolCalling: boolean;
+    structuredOutput: boolean;
+    streaming: boolean;
+    reasoning: boolean;
+    longContext: boolean;
+}
+export interface AIModelPricing {
+    inputPerMillion?: number;
+    outputPerMillion?: number;
+    image?: number;
+    search?: number;
+}
+/** Normalized model record (merged from live listing + curated metadata). */
+export interface AIModel {
+    /** Stable internal id: `${provider}:${providerModelId}`. */
+    id: string;
+    provider: AIProviderKey;
+    providerModelId: string;
+    displayName: string;
+    description?: string;
+    status: AIModelStatus;
+    capabilities: AIModelCapabilities;
+    contextWindow?: number;
+    maxOutputTokens?: number;
+    inputModalities: string[];
+    outputModalities: string[];
+    pricing?: AIModelPricing;
+    aliases?: string[];
+    lastSyncedAt: string;
+    source: 'provider' | 'manual' | 'config';
+    metadata: Record<string, unknown>;
+}
+/**
+ * Stored provider connection. The encrypted key NEVER leaves the server — API
+ * responses use {@link AIProviderConnectionPublic}.
+ */
+export interface AIProviderConnection {
+    id: string;
+    provider: AIProviderKey;
+    displayName: string;
+    enabled: boolean;
+    status: AIConnectionStatus;
+    /** Encrypted via `encryptSecret`. Absent when the key is env-managed. */
+    apiKeyEncrypted?: string;
+    apiKeyLast4?: string;
+    baseUrl?: string;
+    organizationId?: string;
+    projectId?: string;
+    lastTestedAt?: string;
+    lastSuccessfulRunAt?: string;
+    lastModelSyncAt?: string;
+    createdAt: string;
+    updatedAt: string;
+    updatedBy: string;
+}
+/** Client-safe provider view: no key material, source resolved dynamically. */
+export type AIProviderConnectionPublic = Omit<AIProviderConnection, 'apiKeyEncrypted'> & {
+    apiKeySource: AIKeySource;
+    /** True when the key is env-managed and therefore not editable in the UI. */
+    keyManagedExternally: boolean;
+    hasKey: boolean;
+};
+export type AIFeatureCategory = 'seo' | 'media' | 'content' | 'forms' | 'security' | 'developer' | 'search';
+export interface AIFeatureConfig {
+    key: string;
+    label: string;
+    description: string;
+    enabled: boolean;
+    category: AIFeatureCategory;
+    requiredCapabilities: string[];
+    providerId?: string;
+    modelId?: string;
+    fallbackModelIds?: string[];
+    approvalRequired: boolean;
+    allowBulkApply: boolean;
+    maxMonthlyTokens?: number;
+    maxRequestsPerDay?: number;
+    rolesAllowed: string[];
+    permissionsRequired: string[];
+    dataPolicyKey?: string;
+}
+export interface AIBudgetSettings {
+    monthlyTokenLimit?: number;
+    monthlyCostLimit?: number;
+    alertAtPercentages: number[];
+    disableWhenExceeded: boolean;
+    perFeatureLimits?: Record<string, number>;
+    perUserLimits?: Record<string, number>;
+}
+/**
+ * Brand voice profile. A reusable description of how generated copy should
+ * sound, injected into the system prompt of content-generation features so
+ * every AI surface writes in one consistent, on-brand voice. Contains no
+ * secrets — safe to return to the client.
+ */
+export interface BrandVoiceProfile {
+    /** When false, the profile is stored but not injected into prompts. */
+    enabled: boolean;
+    /** Friendly label (e.g. "Acme Marketing"). */
+    name: string;
+    /** Tone descriptors (e.g. "confident, warm, plain-spoken"). */
+    tone: string;
+    /** Who the copy speaks to (e.g. "busy IT directors at mid-market SaaS"). */
+    audience?: string;
+    /** Free-form do/don't rules the model must follow. */
+    guidelines?: string;
+    /** Representative on-brand copy the model can pattern-match against. */
+    sampleText?: string;
+    /** Portable markdown profile (YAML frontmatter + human guidance). */
+    document?: string;
+    /** Monotonic profile version — bumped when the document is regenerated. */
+    version?: number;
+    /** Editorial workflow state for the profile document. */
+    status?: 'draft' | 'reviewed' | 'approved';
+    /** Provenance labels (collections, URLs, uploads) used to build the profile. */
+    generatedFrom?: string[];
+    updatedAt?: string;
+    updatedBy?: string;
+}
+export interface AISettings {
+    defaultProviderId?: string;
+    defaultModelId?: string;
+    defaultTextModelId?: string;
+    defaultReasoningModelId?: string;
+    defaultVisionModelId?: string;
+    defaultEmbeddingModelId?: string;
+    defaultImageGenerationModelId?: string;
+    features: AIFeatureConfig[];
+    budget: AIBudgetSettings;
+    logsRetentionDays: number;
+    /** Active brand voice. Absent until an admin configures it. */
+    brandVoice?: BrandVoiceProfile;
+}
+/**
+ * Cached, normalized model catalog keyed by provider connection id. Persisted in
+ * the `__ai_config__` document so the model selector renders without a live call.
+ */
+export interface AICatalogEntry {
+    models: AIModel[];
+    lastSyncedAt: string;
+    /** True when the entry came from the curated fallback (no live listing). */
+    fromFallback: boolean;
+}
+/** Shape of the `data` blob on the `__ai_config__` Document. */
+export interface AIConfigDocument {
+    providers: AIProviderConnection[];
+    settings: AISettings;
+    catalog?: Record<string, AICatalogEntry>;
+    updatedAt?: string;
+    updatedBy?: string;
+}
+/** Monthly usage summary for the budget meter (real counts; 0 until Phase 4). */
+export interface AIUsageSummary {
+    totalTokens: number;
+    promptTokens: number;
+    completionTokens: number;
+    estimatedCost?: number;
+    monthlyTokenLimit?: number;
+    periodStart: string;
+    periodEnd: string;
+    runCount: number;
+}
+/** Result of an adapter connection test. */
+export interface AIConnectionTestResult {
+    ok: boolean;
+    status: AIConnectionStatus;
+    /** Human-readable detail (safe to show; never contains the key). */
+    message: string;
+    testedAt: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/ai/types.js

@@ -0,0 +1,11 @@
+/**
+ * Shared types for the Settings > AI governance layer.
+ *
+ * Phases 1-2 cover provider connections (encrypted keys) and a dynamic,
+ * normalized model catalog. Feature config, budget, and data-policy shapes are
+ * declared here for forward-compatibility (enforcement + metering land in later
+ * phases) but only `features[].enabled` and `budget.monthlyTokenLimit` are
+ * wired into the UI for now.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/ai/types.js.map

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

package/dist/ai/usage.d.ts

@@ -0,0 +1,18 @@
+/**
+ * AI usage aggregation.
+ *
+ * Until the dedicated per-run metering table lands (Phase 4), usage is derived
+ * from token totals already recorded in `prenta_audit_logs` (`details
+ * .totalTokensUsed` / `details.tokensUsed`). This returns REAL counts — it is 0
+ * when nothing has run, never a fabricated number.
+ */
+import type { AIUsageSummary } from './types.js';
+/**
+ * Sum token usage from audit-log entries within the period. Recognizes the
+ * fields current AI handlers write today and is tolerant of missing data.
+ */
+export declare function getUsageSummary(db: unknown, period?: {
+    start?: Date;
+    end?: Date;
+}): Promise<AIUsageSummary>;
+//# sourceMappingURL=usage.d.ts.map

package/dist/ai/usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../../src/ai/usage.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAgBhD;;;GAGG;AACH,wBAAsB,eAAe,CACnC,EAAE,EAAE,OAAO,EACX,MAAM,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,IAAI,CAAC;IAAC,GAAG,CAAC,EAAE,IAAI,CAAA;CAAE,GACpC,OAAO,CAAC,cAAc,CAAC,CAiDzB"}

package/dist/ai/usage.js

@@ -0,0 +1,70 @@
+/**
+ * AI usage aggregation.
+ *
+ * Until the dedicated per-run metering table lands (Phase 4), usage is derived
+ * from token totals already recorded in `prenta_audit_logs` (`details
+ * .totalTokensUsed` / `details.tokensUsed`). This returns REAL counts — it is 0
+ * when nothing has run, never a fabricated number.
+ */
+import { getAIConfig } from './config-store.js';
+/** First instant of the current calendar month (UTC). */
+function monthStart(now = new Date()) {
+    return new Date(Date.UTC(now.getUTCFullYear(), now.getUTCMonth(), 1, 0, 0, 0, 0));
+}
+/** First instant of the next calendar month (UTC). */
+function nextMonthStart(now = new Date()) {
+    return new Date(Date.UTC(now.getUTCFullYear(), now.getUTCMonth() + 1, 1, 0, 0, 0, 0));
+}
+function num(value) {
+    return typeof value === 'number' && Number.isFinite(value) && value > 0 ? value : 0;
+}
+/**
+ * Sum token usage from audit-log entries within the period. Recognizes the
+ * fields current AI handlers write today and is tolerant of missing data.
+ */
+export async function getUsageSummary(db, period) {
+    const start = period?.start ?? monthStart();
+    const end = period?.end ?? nextMonthStart();
+    const config = await getAIConfig(db);
+    const monthlyTokenLimit = config.settings.budget.monthlyTokenLimit;
+    const base = {
+        totalTokens: 0,
+        promptTokens: 0,
+        completionTokens: 0,
+        monthlyTokenLimit,
+        periodStart: start.toISOString(),
+        periodEnd: end.toISOString(),
+        runCount: 0,
+    };
+    const d = db;
+    if (!d?.auditLog?.findMany)
+        return base;
+    let rows = [];
+    try {
+        rows = await d.auditLog.findMany({
+            where: { timestamp: { gte: start, lt: end } },
+            select: { details: true },
+        });
+    }
+    catch {
+        return base;
+    }
+    let totalTokens = 0;
+    let promptTokens = 0;
+    let completionTokens = 0;
+    let runCount = 0;
+    for (const row of rows) {
+        const details = (row?.details ?? {});
+        const total = num(details.totalTokensUsed) + num(details.tokensUsed) + num(details.totalTokens);
+        const prompt = num(details.promptTokens);
+        const completion = num(details.completionTokens);
+        if (total > 0 || prompt > 0 || completion > 0) {
+            runCount += 1;
+            totalTokens += total > 0 ? total : prompt + completion;
+            promptTokens += prompt;
+            completionTokens += completion;
+        }
+    }
+    return { ...base, totalTokens, promptTokens, completionTokens, runCount };
+}
+//# sourceMappingURL=usage.js.map

package/dist/ai/usage.js.map

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

package/dist/api/collection-introspection.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Field-schema introspection for the `GET /api/cms/collections` discovery
+ * endpoint (roadmap WS-B4).
+ *
+ * Reduces a collection's field map to a compact, **recursive** summary an
+ * agent can plan a create/update against — including `array` element
+ * subfields and `blocks` variant subfields — WITHOUT shipping the full
+ * runtime validators, hooks, or access functions (those can carry closure
+ * state and must never reach the unauthenticated discovery surface).
+ *
+ * The shape is intentionally additive over the flat `{ name, type, required }`
+ * summary: relationship targets, select options, and nested subfield schemas
+ * appear only when present, so existing consumers keep working.
+ */
+/** A single field reduced to agent-plannable metadata. */
+export interface FieldSummary {
+    name: string;
+    type: string;
+    required: boolean;
+    /** Relationship target collection(s) — for slug→id resolution. */
+    relationTo?: string | string[];
+    /** True for multi-value relationship / select fields. */
+    hasMany?: boolean;
+    /** `select` options exactly as the config provides them (label/value objects or bare strings). */
+    options?: unknown[];
+    /** `array` element subfields (recursive). */
+    fields?: FieldSummary[];
+    /** `array` row bounds, when configured. */
+    minRows?: number;
+    maxRows?: number;
+    /** `blocks` variants, each with its own subfield schema (recursive). */
+    blocks?: BlockSummary[];
+}
+/** A `blocks` field variant reduced to its slug, label, and subfield schema. */
+export interface BlockSummary {
+    slug: string;
+    label?: string;
+    fields: FieldSummary[];
+}
+/**
+ * Summarize a collection's `fields` map into the recursive {@link FieldSummary}
+ * array used by the discovery endpoint. Safe on any input — a non-object map
+ * (or a missing one) yields `[]`.
+ */
+export declare function summarizeCollectionFields(fields: unknown, depth?: number): FieldSummary[];
+//# sourceMappingURL=collection-introspection.d.ts.map

package/dist/api/collection-introspection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collection-introspection.d.ts","sourceRoot":"","sources":["../../src/api/collection-introspection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,0DAA0D;AAC1D,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,OAAO,CAAA;IACjB,kEAAkE;IAClE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;IAC9B,yDAAyD;IACzD,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,kGAAkG;IAClG,OAAO,CAAC,EAAE,OAAO,EAAE,CAAA;IACnB,6CAA6C;IAC7C,MAAM,CAAC,EAAE,YAAY,EAAE,CAAA;IACvB,2CAA2C;IAC3C,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,wEAAwE;IACxE,MAAM,CAAC,EAAE,YAAY,EAAE,CAAA;CACxB;AAED,gFAAgF;AAChF,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,YAAY,EAAE,CAAA;CACvB;AA2BD;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,SAAI,GAAG,YAAY,EAAE,CAGpF"}

package/dist/api/collection-introspection.js

@@ -0,0 +1,82 @@
+/**
+ * Field-schema introspection for the `GET /api/cms/collections` discovery
+ * endpoint (roadmap WS-B4).
+ *
+ * Reduces a collection's field map to a compact, **recursive** summary an
+ * agent can plan a create/update against — including `array` element
+ * subfields and `blocks` variant subfields — WITHOUT shipping the full
+ * runtime validators, hooks, or access functions (those can carry closure
+ * state and must never reach the unauthenticated discovery surface).
+ *
+ * The shape is intentionally additive over the flat `{ name, type, required }`
+ * summary: relationship targets, select options, and nested subfield schemas
+ * appear only when present, so existing consumers keep working.
+ */
+/**
+ * Defensive recursion cap. Configs are static and authored by the developer,
+ * so cycles are not expected, but a malformed/self-referential config must
+ * never be able to blow the stack or balloon the response. Five levels is far
+ * deeper than any realistic page/array/blocks nesting.
+ */
+const MAX_DEPTH = 5;
+function isFieldMap(value) {
+    return !!value && typeof value === 'object' && !Array.isArray(value);
+}
+/**
+ * Summarize a collection's `fields` map into the recursive {@link FieldSummary}
+ * array used by the discovery endpoint. Safe on any input — a non-object map
+ * (or a missing one) yields `[]`.
+ */
+export function summarizeCollectionFields(fields, depth = 0) {
+    if (!isFieldMap(fields))
+        return [];
+    return Object.entries(fields).map(([name, fieldDef]) => summarizeField(name, fieldDef, depth));
+}
+function summarizeField(name, fieldDef, depth) {
+    const summary = {
+        name,
+        type: typeof fieldDef?.type === 'string' ? fieldDef.type : 'unknown',
+        required: fieldDef?.required === true,
+    };
+    // Relationship target collection(s) — the agent needs this to resolve a
+    // slug→id for a relationship field.
+    if (typeof fieldDef?.relationTo === 'string' || Array.isArray(fieldDef?.relationTo)) {
+        summary.relationTo = fieldDef.relationTo;
+    }
+    if (fieldDef?.hasMany === true || fieldDef?.multiple === true)
+        summary.hasMany = true;
+    // Select options (label/value pairs or bare strings) so the agent can fill enums.
+    if (Array.isArray(fieldDef?.options))
+        summary.options = fieldDef.options;
+    // Stop recursing past the cap, but still emit the field's own metadata.
+    if (depth >= MAX_DEPTH)
+        return summary;
+    // `array`: recurse into the element subfields so an agent knows the shape of
+    // each row it must author.
+    if (summary.type === 'array' && isFieldMap(fieldDef?.fields)) {
+        summary.fields = summarizeCollectionFields(fieldDef.fields, depth + 1);
+        if (typeof fieldDef.minRows === 'number')
+            summary.minRows = fieldDef.minRows;
+        if (typeof fieldDef.maxRows === 'number')
+            summary.maxRows = fieldDef.maxRows;
+    }
+    // `blocks`: recurse into each block variant's subfields, keyed by the block
+    // slug (the discriminator the agent writes as `blockType`).
+    if (summary.type === 'blocks' && Array.isArray(fieldDef?.blocks)) {
+        summary.blocks = fieldDef.blocks
+            .filter((b) => !!b && typeof b === 'object')
+            .map((b) => {
+            const slug = typeof b.slug === 'string' ? b.slug : 'unknown';
+            const labels = b.labels;
+            const block = {
+                slug,
+                fields: summarizeCollectionFields(b.fields, depth + 1),
+            };
+            if (typeof labels?.singular === 'string')
+                block.label = labels.singular;
+            return block;
+        });
+    }
+    return summary;
+}
+//# sourceMappingURL=collection-introspection.js.map

package/dist/api/collection-introspection.js.map

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

package/dist/api/guarded-db.d.ts

@@ -0,0 +1,14 @@
+import type { PrentaDB } from '../db/client-types.js';
+export declare class ModelNotAvailableError extends Error {
+    readonly model: string;
+    constructor(model: string);
+}
+/**
+ * Returns the Prisma client wrapped in a Proxy that throws a typed
+ * {@link ModelNotAvailableError} when a route touches a model that isn't in
+ * the consumer's schema (instead of an opaque `undefined` TypeError). When
+ * the DB client itself can't be obtained, every model access throws so each
+ * route's error handler can translate it into a 503-style response.
+ */
+export declare function guardedDb(): PrentaDB;
+//# sourceMappingURL=guarded-db.d.ts.map

package/dist/api/guarded-db.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guarded-db.d.ts","sourceRoot":"","sources":["../../src/api/guarded-db.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAA;AAKrD,qBAAa,sBAAuB,SAAQ,KAAK;IAC/C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;gBACV,KAAK,EAAE,MAAM;CAI1B;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,IAAI,QAAQ,CA2CpC"}

package/dist/api/guarded-db.js

@@ -0,0 +1,62 @@
+import { getDB } from '../db.js';
+import { createLogger } from '../diagnostics/logger.js';
+const dbLogger = createLogger('db');
+export class ModelNotAvailableError extends Error {
+    model;
+    constructor(model) {
+        super(`Model "${model}" is not available in the Prisma schema.`);
+        this.model = model;
+    }
+}
+/**
+ * Returns the Prisma client wrapped in a Proxy that throws a typed
+ * {@link ModelNotAvailableError} when a route touches a model that isn't in
+ * the consumer's schema (instead of an opaque `undefined` TypeError). When
+ * the DB client itself can't be obtained, every model access throws so each
+ * route's error handler can translate it into a 503-style response.
+ */
+export function guardedDb() {
+    let d;
+    try {
+        d = getDB();
+    }
+    catch (err) {
+        dbLogger.error('Failed to obtain database client', {
+            error: err instanceof Error ? err.message : String(err),
+        });
+        return new Proxy({}, {
+            get(_target, prop) {
+                if (typeof prop !== 'string' || prop.startsWith('$') || prop === 'then')
+                    return undefined;
+                return new Proxy({}, {
+                    get() {
+                        throw new ModelNotAvailableError(String(prop));
+                    },
+                });
+            },
+        });
+    }
+    return new Proxy(d, {
+        get(target, prop) {
+            if (typeof prop !== 'string')
+                return Reflect.get(target, prop);
+            if (prop.startsWith('$') || prop === 'then')
+                return Reflect.get(target, prop);
+            let val;
+            try {
+                val = target[prop];
+            }
+            catch {
+                val = undefined;
+            }
+            if (val !== undefined && val !== null)
+                return val;
+            return new Proxy({}, {
+                get() {
+                    throw new ModelNotAvailableError(String(prop));
+                },
+            });
+        },
+    });
+}
+//# sourceMappingURL=guarded-db.js.map

package/dist/api/guarded-db.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guarded-db.js","sourceRoot":"","sources":["../../src/api/guarded-db.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,UAAU,CAAA;AAEhC,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAEvD,MAAM,QAAQ,GAAG,YAAY,CAAC,IAAI,CAAC,CAAA;AAEnC,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IACtC,KAAK,CAAQ;IACtB,YAAY,KAAa;QACvB,KAAK,CAAC,UAAU,KAAK,0CAA0C,CAAC,CAAA;QAChE,IAAI,CAAC,KAAK,GAAG,KAAK,CAAA;IACpB,CAAC;CACF;AAED;;;;;;GAMG;AACH,MAAM,UAAU,SAAS;IACvB,IAAI,CAAW,CAAA;IACf,IAAI,CAAC;QACH,CAAC,GAAG,KAAK,EAAY,CAAA;IACvB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,QAAQ,CAAC,KAAK,CAAC,kCAAkC,EAAE;YACjD,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;SACxD,CAAC,CAAA;QACF,OAAO,IAAI,KAAK,CAAC,EAAS,EAAE;YAC1B,GAAG,CAAC,OAAO,EAAE,IAAI;gBACf,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,IAAI,KAAK,MAAM;oBAAE,OAAO,SAAS,CAAA;gBACzF,OAAO,IAAI,KAAK,CACd,EAAE,EACF;oBACE,GAAG;wBACD,MAAM,IAAI,sBAAsB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAA;oBAChD,CAAC;iBACF,CACF,CAAA;YACH,CAAC;SACF,CAAC,CAAA;IACJ,CAAC;IACD,OAAO,IAAI,KAAK,CAAC,CAAC,EAAE;QAClB,GAAG,CAAC,MAAM,EAAE,IAAI;YACd,IAAI,OAAO,IAAI,KAAK,QAAQ;gBAAE,OAAO,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;YAC9D,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,IAAI,KAAK,MAAM;gBAAE,OAAO,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;YAC7E,IAAI,GAAY,CAAA;YAChB,IAAI,CAAC;gBACH,GAAG,GAAI,MAA6C,CAAC,IAAI,CAAC,CAAA;YAC5D,CAAC;YAAC,MAAM,CAAC;gBACP,GAAG,GAAG,SAAS,CAAA;YACjB,CAAC;YACD,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,IAAI;gBAAE,OAAO,GAAG,CAAA;YACjD,OAAO,IAAI,KAAK,CACd,EAAE,EACF;gBACE,GAAG;oBACD,MAAM,IAAI,sBAAsB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAA;gBAChD,CAAC;aACF,CACF,CAAA;QACH,CAAC;KACF,CAAC,CAAA;AACJ,CAAC"}

package/dist/api/handler-factory.d.ts

@@ -0,0 +1,7 @@
+export interface HandlePrentaAPIOptions {
+    config?: unknown;
+    prismaClient?: unknown;
+    prismaClientGetter?: () => Promise<unknown>;
+}
+export declare function handlePrentaAPI(options?: HandlePrentaAPIOptions): (request: Request) => Promise<Response>;
+//# sourceMappingURL=handler-factory.d.ts.map

package/dist/api/handler-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler-factory.d.ts","sourceRoot":"","sources":["../../src/api/handler-factory.ts"],"names":[],"mappings":"AA2GA,MAAM,WAAW,sBAAsB;IACrC,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,kBAAkB,CAAC,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAA;CAC5C;AAMD,wBAAgB,eAAe,CAAC,OAAO,GAAE,sBAA2B,IAgLpC,SAAS,OAAO,KAAG,OAAO,CAAC,QAAQ,CAAC,CAyJnE"}