@dyrected/core 2.11.0 → 2.13.0

package/dist/access-P6Z2XAFS.js

@@ -0,0 +1,10 @@
+import {
+  isAccessAllowed,
+  resolveAccess
+} from "./chunk-HRRJ3RYT.js";
+import "./chunk-27YRIGK5.js";
+import "./chunk-JSBRDJBE.js";
+export {
+  isAccessAllowed,
+  resolveAccess
+};

package/dist/ai-X3M2SE5A.js

@@ -0,0 +1,17 @@
+import {
+  AI_ACTIONS_COLLECTION,
+  AI_AUDIT_COLLECTION,
+  AI_CHUNKS_COLLECTION,
+  AI_MESSAGES_COLLECTION,
+  AI_THREADS_COLLECTION,
+  isAICollection
+} from "./chunk-4RAQJVJM.js";
+import "./chunk-JSBRDJBE.js";
+export {
+  AI_ACTIONS_COLLECTION,
+  AI_AUDIT_COLLECTION,
+  AI_CHUNKS_COLLECTION,
+  AI_MESSAGES_COLLECTION,
+  AI_THREADS_COLLECTION,
+  isAICollection
+};

package/dist/ai-tools-UPKJY3TX.js

@@ -0,0 +1,14 @@
+import {
+  createDyrectedAITools,
+  validatePayloadAgainstFields
+} from "./chunk-W7GKJM2X.js";
+import "./chunk-ZYYDTHF3.js";
+import "./chunk-254THFDS.js";
+import "./chunk-4RAQJVJM.js";
+import "./chunk-HRRJ3RYT.js";
+import "./chunk-27YRIGK5.js";
+import "./chunk-JSBRDJBE.js";
+export {
+  createDyrectedAITools,
+  validatePayloadAgainstFields
+};

package/dist/{app-config-6U_Kum-Z.d.cts → app-D_ODsBWA.d.cts}

@@ -1,5 +1,11 @@
-import { icons } from 'lucide-react';
+import * as hono_types from 'hono/types';
+import { Context, Hono } from 'hono';
 import { LoggerOptions, DestinationStream, Logger } from 'pino';
+import { icons } from 'lucide-react';
+import { z } from 'zod';
+import { JWTPayload } from 'jose';
+import { Tracer, Counter, Attributes, Histogram, Span } from '@opentelemetry/api';
+import { PrometheusExporter } from '@opentelemetry/exporter-prometheus';
 
 /**
  * Minimum HTTP request context passed to every server-side hook and resolver.
@@ -136,12 +142,15 @@ interface PaginatedResult<T = Record<string, any>> {
  */
 interface FileData {
     filename: string;
+    originalFilename?: string;
     filesize?: number;
     mimeType: string;
     /** Public URL of the stored file. */
     url: string;
     width?: number;
     height?: number;
+    aspectRatio?: number;
+    folderId?: string | null;
     focalPoint?: {
         x: number;
         y: number;
@@ -152,8 +161,290 @@ interface FileData {
     type?: "upload" | "external";
     provider?: string;
     provider_metadata?: unknown;
+    metadata?: Record<string, unknown>;
+    [key: string]: unknown;
+}
+
+interface AIThread {
+    id: string;
+    projectId: string;
+    userId: string;
+    title?: string;
+    summary?: string;
+    createdAt: Date | string;
+    updatedAt: Date | string;
+    [key: string]: unknown;
+}
+interface AIMessage {
+    id: string;
+    threadId: string;
+    role: 'user' | 'assistant' | 'system';
+    content: string;
+    parts?: any[];
+    createdAt: Date | string;
+    metadata?: Record<string, unknown>;
+    [key: string]: unknown;
+}
+interface DyrectedAIContext {
+    project: {
+        name: string;
+        id: string;
+    };
+    globalPrompt?: string;
+    collections: Array<{
+        slug: string;
+        label?: string;
+        prompt?: string;
+        fields?: Array<{
+            name: string;
+            type: string;
+            required?: boolean;
+        }>;
+    }>;
+    globals: Array<{
+        slug: string;
+        label?: string;
+        prompt?: string;
+    }>;
+    user: {
+        name?: string;
+        role?: string;
+    };
+}
+interface AIToolContext {
+    db: any;
+    user?: any;
+    projectId?: string;
+    config?: any;
+}
+interface AIToolDefinition<TParams = any, TResult = any> {
+    description: string;
+    inputSchema?: z.ZodType<TParams>;
+    parameters?: z.ZodType<TParams>;
+    execute: (args: TParams, context: AIToolContext) => Promise<TResult> | TResult;
+}
+interface GlobalRAGConfig {
+    /** Enable or disable automatic RAG indexing globally. Defaults to true. */
+    enabled?: boolean;
+    /** Embedding model identifier. Defaults to 'text-embedding-004' (Google) or 'text-embedding-3-small' (OpenAI/AgentRouter). */
+    embeddingModel?: string;
+    /** Default character budget per chunk. Defaults to 1500 (~375-500 tokens). */
+    maxChunkSize?: number;
+    /** Default character overlap between chunks. Defaults to 150. */
+    chunkOverlap?: number;
+    /** Default minimum cosine similarity score threshold (0.0 to 1.0). Defaults to 0.45. */
+    minScore?: number;
+    /** Default number of top snippets to retrieve. Defaults to 4. */
+    topK?: number;
+}
+interface CollectionRAGConfig {
+    /** Enable or disable RAG indexing for this collection. Defaults to true. */
+    enabled?: boolean;
+    /** Whitelist of specific field names to index. Defaults to all text/richText/textarea fields. */
+    fields?: string[];
+    /** Field to use for citation display titles (e.g. 'title', 'name', 'question'). */
+    titleField?: string;
+    /** Custom character budget per chunk for this collection. */
+    maxChunkSize?: number;
+    /** Custom character overlap between chunks for this collection. */
+    chunkOverlap?: number;
+}
+interface AIChunk {
+    id: string;
+    projectId: string;
+    collection: string;
+    documentId: string;
+    field: string;
+    chunkIndex: number;
+    text: string;
+    embedding: number[];
+    tokenCount: number;
+    contentHash: string;
+    metadata?: {
+        title?: string;
+        slug?: string;
+        locale?: string;
+        status?: string;
+        updatedAt?: Date | string;
+        [key: string]: unknown;
+    };
+    createdAt: Date | string;
+    updatedAt: Date | string;
+    [key: string]: unknown;
+}
+interface RAGSearchResult {
+    id: string;
+    collection: string;
+    documentId: string;
+    title: string;
+    field: string;
+    score: number;
+    text: string;
+    url: string;
+    metadata?: Record<string, unknown>;
+}
+interface AIRateLimitResult {
+    allowed: boolean;
+    remaining: number;
+    resetTimeSec: number;
+    retryAfter?: number;
+}
+interface AIRateLimitStore {
+    consume(key: string, limit: number, windowMs: number): Promise<AIRateLimitResult> | AIRateLimitResult;
+}
+interface AIConfig {
+    /** Master switch to enable/disable AI endpoints. Defaults to true. */
+    enabled?: boolean;
+    /** AI Provider to use. Defaults to 'google' or auto-detects from environment variables. */
+    provider?: 'google' | 'agentrouter' | 'openrouter' | 'openai' | 'custom';
+    /** Custom base URL for OpenAI-compatible gateways (e.g. https://agentrouter.org/v1). */
+    baseURL?: string;
+    /** Optional custom API key (or read from environment variables). */
+    apiKey?: string;
+    /** Global system prompt / brand persona instructions for the project. */
+    systemPrompt?: string;
+    /** Model to use for AI assistant. Defaults to 'gemini-2.0-flash' for Google or 'claude-3-haiku-20240307' for AgentRouter. */
+    model?: string;
+    /** Fallback model to use if primary model hits rate limits. */
+    fallbackModel?: string;
+    /** Maximum number of sequential tool execution steps per user message. Defaults to 5. */
+    maxSteps?: number;
+    /** Number of automatic retry attempts on transient rate limits / network errors. Defaults to 3. */
+    maxRetries?: number;
+    /** Rate limiting options per user and per project. */
+    rateLimit?: {
+        userMax?: number;
+        projectMax?: number;
+        store?: AIRateLimitStore;
+    };
+    /** Global RAG (Retrieval-Augmented Generation) configuration options. */
+    rag?: GlobalRAGConfig;
+    /** Conversation compaction options. */
+    compaction?: {
+        enabled?: boolean;
+        maxMessages?: number;
+        recentMessagesCount?: number;
+    };
+    /** Automated PII redaction and de-identification settings. */
+    pii?: AIPIIConfig;
+    /** Custom developer-defined tools. */
+    tools?: Record<string, AIToolDefinition>;
+}
+type AIPIIPattern = "email" | "phone" | "phone_number" | "phoneNumber" | "ssn" | "credit_card" | "ipv4" | "ipv6" | "iban" | "api_key" | "jwt" | "passport";
+interface AIPIIConfig {
+    /** If true, automatically scrubs known PII from unstructured text before AI embedding or inference. */
+    enabled?: boolean;
+    /** Patterns to scrub. Defaults to ['email', 'phone', 'ssn', 'credit_card', 'ipv4']. */
+    patterns?: AIPIIPattern[];
+    /** Redaction strategy: 'mask' (e.g. b***@example.com) or 'token' (e.g. [REDACTED_EMAIL]). Defaults to 'mask'. */
+    strategy?: 'mask' | 'token';
+    /** Optional custom scrubber function to transform text before AI consumption. */
+    customScrubber?: (text: string) => string;
+}
+interface CollectionSummaryResult {
+    slug: string;
+    label: string;
+    auth: boolean;
+    timestamps: boolean;
+}
+interface CollectionSchemaResult {
+    slug: string;
+    label: string;
+    auth: boolean;
+    fields: Array<{
+        name: string;
+        type: string;
+        label?: string;
+        required: boolean;
+        unique: boolean;
+        relationTo?: string;
+        options?: any;
+    }>;
+}
+interface GlobalSummaryResult {
+    slug: string;
+    label: string;
+}
+interface GlobalSchemaResult {
+    slug: string;
+    label: string;
+    fields: Array<{
+        name: string;
+        type: string;
+        label?: string;
+        required: boolean;
+    }>;
+    data: Record<string, unknown> | null;
+}
+interface QueryCollectionResult {
+    collection: string;
+    docs: Array<Record<string, unknown>>;
+    total: number;
+    totalPages: number;
+    page: number;
+    limit: number;
+}
+interface GetDocumentResult {
+    collection: string;
+    doc: Record<string, unknown>;
+}
+interface AggregateCollectionResult {
+    collection: string;
+    result: Record<string, unknown>;
+}
+type AIActionType = 'createDocument' | 'updateDocument' | 'deleteDocument' | 'updateGlobal';
+type AIActionStatus = 'pending' | 'approved' | 'rejected' | 'executed' | 'failed';
+interface AIAction {
+    id: string;
+    projectId: string;
+    threadId?: string;
+    userId?: string;
+    type: AIActionType;
+    targetCollection?: string;
+    targetGlobal?: string;
+    documentId?: string;
+    summary: string;
+    beforeSnapshot?: Record<string, unknown> | null;
+    proposedData: Record<string, unknown>;
+    status: AIActionStatus;
+    errorMessage?: string;
+    expiresAt: Date | string;
+    createdAt: Date | string;
+    executedAt?: Date | string;
     [key: string]: unknown;
 }
+type AIAuditActionType = AIActionType | 'chat_turn' | 'rag_search' | 'action_rejected';
+interface AIAuditRecord {
+    id: string;
+    projectId: string;
+    actionId?: string;
+    threadId?: string;
+    executedBy?: string;
+    actionType: AIAuditActionType;
+    target: string;
+    snapshotBefore?: Record<string, unknown> | null;
+    snapshotAfter?: Record<string, unknown> | null;
+    rollbackPayload?: Record<string, unknown> | null;
+    tokens?: {
+        promptTokens?: number;
+        completionTokens?: number;
+        totalTokens?: number;
+    };
+    estimatedCostUsd?: number;
+    latencyMs?: {
+        total?: number;
+        retrieval?: number;
+        generation?: number;
+    };
+    createdAt: Date | string;
+    [key: string]: unknown;
+}
+declare const AI_THREADS_COLLECTION = "_dyrected_ai_threads";
+declare const AI_MESSAGES_COLLECTION = "_dyrected_ai_messages";
+declare const AI_CHUNKS_COLLECTION = "_dyrected_ai_chunks";
+declare const AI_ACTIONS_COLLECTION = "_dyrected_ai_actions";
+declare const AI_AUDIT_COLLECTION = "_dyrected_ai_audit";
+declare function isAICollection(slug: string): boolean;
 
 /** A valid icon component name from the Lucide icon set bundled with Dyrected Admin. */
 type AdminIconName = keyof typeof icons;
@@ -1739,6 +2030,21 @@ interface CollectionConfig<TDoc extends object = Record<string, unknown>> {
          */
         urlPattern?: string;
     };
+    /**
+     * Optional custom AI assistant instructions and RAG indexing options for this collection.
+     */
+    ai?: {
+        /** Specific editorial guidelines, brand voice, or instructions for this collection. */
+        prompt?: string;
+        /** Collection-level RAG (Retrieval-Augmented Generation) indexing settings. */
+        rag?: CollectionRAGConfig;
+        /** Field names to completely omit from AI context and RAG indexing. */
+        excludeFields?: string[];
+        /** Field names to mask (e.g. j***@example.com) before sending to AI. */
+        redactFields?: string[];
+        /** Custom hook to transform/sanitize/pseudonymize documents before AI inspection. */
+        sanitizeDoc?: (doc: Record<string, unknown>) => Record<string, unknown>;
+    };
     /**
      * Detail view layout configuration for the Admin UI.
      *
@@ -1884,6 +2190,13 @@ interface GlobalConfig<TDoc extends object = Record<string, unknown>> {
         /** If `true`, this global is not shown in the Admin UI sidebar. */
         hidden?: boolean;
     };
+    /**
+     * Optional custom AI assistant instructions for this global singleton.
+     */
+    ai?: {
+        /** Specific guidelines, context, or instructions when interacting with this global. */
+        prompt?: string;
+    };
     /**
      * Initial data to seed this global with the first time it is fetched and
      * found to be empty.
@@ -1992,6 +2305,39 @@ interface DatabaseAdapter {
  * and `afterDelete` hooks where the full {@link DatabaseAdapter} is provided.
  */
 type ReadonlyDatabaseAdapter = Pick<DatabaseAdapter, "find" | "findOne" | "getGlobal" | "aggregate">;
+/**
+ * Options for dynamic on-the-fly image transformations.
+ */
+interface ImageTransformOptions {
+    /** Target width in pixels. */
+    width?: number;
+    /** Target height in pixels. */
+    height?: number;
+    /** Aspect ratio string (e.g. "16:9", "1:1") or numeric ratio (e.g. 1.777). */
+    aspectRatio?: string | number;
+    /** Crop strategy. */
+    crop?: "fill" | "fit" | "limit" | "pad" | "thumb" | "scale" | "cover" | "contain";
+    /** Gravity / focal anchor for cropping. */
+    gravity?: "auto" | "face" | "center" | "focal" | "xy_center" | string;
+    /** Explicit focal point percentage coordinates (0.0 to 1.0). */
+    focalPoint?: {
+        x: number;
+        y: number;
+    };
+    /** Output quality (1-100 or 'auto'). */
+    quality?: number | "auto" | "auto:best" | "auto:good" | "auto:eco";
+    /** Target image format. */
+    format?: "auto" | "webp" | "avif" | "png" | "jpg" | "jpeg";
+    /** Blur radius for placeholders/effects. */
+    blur?: number;
+    /** Rotation angle in degrees (e.g. 90, 180, 270). */
+    rotate?: number;
+    /** Device pixel ratio multiplier. */
+    dpr?: number | "auto";
+    /** Named transformation preset key. */
+    key?: string;
+    [key: string]: unknown;
+}
 /**
  * The interface every storage adapter must implement.
  *
@@ -2014,9 +2360,10 @@ interface StorageAdapter {
     delete(args: {
         filename: string;
     }): Promise<void>;
-    /** Return the public URL for a stored file. */
+    /** Return the public URL for a stored file, with optional dynamic transformations. */
     getURL(args: {
         filename: string;
+        transform?: ImageTransformOptions;
     }): string;
     /**
      * Retrieve the file's raw bytes and MIME type for serving via the API.
@@ -2179,6 +2526,15 @@ interface FieldBase {
     renameTo?: string;
     /** Whether SQL adapters should promote this field into a first-class column. */
     promoted?: boolean;
+    /** AI assistant privacy and PII redaction settings for this field. */
+    ai?: {
+        /** If true, completely removes this field from AI queries, RAG chunks, and context. */
+        exclude?: boolean;
+        /** If true or 'mask', masks the field value (e.g. b***@example.com) before sending to AI. */
+        redact?: boolean | 'mask';
+        /** If true, opts out of automatic default PII masking (e.g. for email/phone fields). */
+        allowRaw?: boolean;
+    };
 }
 interface BaseFieldAdmin {
     /** Placeholder text shown when the input has no value. */
@@ -2247,8 +2603,8 @@ interface FieldAdminOnChangeHookArgs<TValue = unknown> {
     docs?: Record<string, unknown>[];
     /** Current authenticated user. */
     user?: unknown;
-    /** Imperative setter for async or derived updates. */
-    setValue: (value: unknown) => void;
+    /** Imperative setter for current field or sibling fields. */
+    setValue: (nameOrVal: string | unknown, maybeVal?: unknown) => void;
 }
 type FieldAdminOnChangeHook<TValue = unknown> = (args: FieldAdminOnChangeHookArgs<TValue>) => unknown;
 type FieldAdminHooks<TValue> = {
@@ -2593,6 +2949,10 @@ type JoinFieldAdmin = {
     showCreateButton?: boolean;
     /** Whether the join field should show the "View all" action in the Admin UI. Defaults to `true`. */
     showViewButton?: boolean;
+    /** Display layout for the join list: 'list' (default) or 'table'. */
+    layout?: "list" | "table";
+    /** Columns to display when layout is 'table'. */
+    columns?: string[];
 };
 interface UrlLinkValue {
     /** Whether the link is a custom URL or a reference to an internal document. */
@@ -2972,6 +3332,15 @@ interface DyrectedConfig<TUser extends AuthenticatedUser = AuthenticatedUser> {
      * @see ImageService
      */
     image?: ImageService;
+    /**
+     * Media management, dynamic transformations, and transformation preset configurations.
+     */
+    media?: {
+        /** Whether to restrict dynamic transformations to registered preset keys in production. */
+        restrictTransforms?: boolean;
+        /** Named transformation presets available via `?key=name`. */
+        presets?: Record<string, ImageTransformOptions>;
+    };
     /**
      * Runtime logger configuration. Accepts either logger options/destination or
      * a fully-instantiated Pino logger.
@@ -3102,6 +3471,156 @@ interface DyrectedConfig<TUser extends AuthenticatedUser = AuthenticatedUser> {
         admin?: AdminConfig;
         adminAuth?: AdminAuthConfig;
     }>;
+    /**
+     * AI Assistant and LLM tools configuration.
+     */
+    ai?: AIConfig;
 }
 
-export { type RadioField as $, type AdminAuthConfig as A, type Block as B, type CollectionConfig as C, type DyrectedConfig as D, type DetailText as E, type Field as F, type GlobalConfig as G, type HookRequestContext as H, type DetailSchema as I, type ArrayField as J, type BlocksField as K, type LifecycleEventName as L, type BooleanField as M, type AuthConfig as N, type AccessPolicyResolver as O, type PublicAdminAuthConfig as P, type DateField as Q, type DateTimeField as R, type EmailField as S, type IconField as T, type ImageField as U, type JoinField as V, type WorkflowConfig as W, type JsonField as X, type MultiSelectField as Y, type NumberField as Z, type ObjectField as _, type DeclarativeHookExpression as a, type DistinctValuesOperation as a$, type RelationshipField as a0, type RichTextField as a1, type RowField as a2, type SelectField as a3, type TextField as a4, type TextareaField as a5, type TimeField as a6, type UrlField as a7, type AccessConfig as a8, type AccessFunction as a9, type BooleanFormat as aA, type CharacterLimitFieldAdmin as aB, type CharacterLimitFieldConfig as aC, type CollectionAfterChangeHook as aD, type CollectionAfterDeleteHook as aE, type CollectionAfterReadHook as aF, type CollectionAfterReadHookEntry as aG, type CollectionAfterTransitionHook as aH, type CollectionBeforeChangeHook as aI, type CollectionBeforeChangeHookEntry as aJ, type CollectionBeforeDeleteHook as aK, type CollectionBeforeReadHook as aL, type CollectionBeforeReadHookEntry as aM, type CollectionBeforeTransitionHook as aN, type CollectionListComponentSlots as aO, type CollectionViewComponentSlots as aP, type CountOperation as aQ, type CustomAdminAuthProvider as aR, type DatabaseAdapter as aS, type DateFieldAdmin as aT, type DateFormat as aU, type DefineActionOptions as aV, type DefineViewOptions as aW, type DetailSpan as aX, type DisplayTone as aY, type DisplayVariant as aZ, type DistinctCountOperation as a_, type AccessFunctionArgs as aa, type AccessResult as ab, type AccessRule as ac, type ActionConfig as ad, type ActionContext as ae, type ActionType as af, type AdminAuthAccessResolution as ag, type AdminAuthClaimMapping as ah, type AdminAuthMember as ai, type AdminAuthProvider as aj, type AdminAuthProviderMembersConfig as ak, type AdminAuthProvisioningMode as al, type AdminAuthResolveAccessArgs as am, type AdminAuthResolvedIdentity as an, type AdminConfig as ao, type AdminDashboardComponentSlots as ap, type AdminIconName as aq, type AggregateArgs as ar, type AggregateCastType as as, type AggregateInput as at, type AggregateOperation as au, type AggregateResult as av, type BaseAdminAuthProvider as aw, type BaseFieldAdmin as ax, type BlockVariant as ay, type BooleanFieldAdmin as az, type AuthenticatedUser as b, type TrustProxyConfig as b$, type DynamicOptionItem as b0, type DynamicOptionsConfig as b1, type DynamicOptionsResolver as b2, type DynamicOptionsResolverArgs as b3, type DyrectedLoggerConfig as b4, type DyrectedObservabilityConfig as b5, type EmailFieldAdmin as b6, type FieldAdminHooks as b7, type FieldAdminOnChangeHook as b8, type FieldAdminOnChangeHookArgs as b9, type JsonFormat as bA, LIFECYCLE_EVENT_NAMES as bB, type LifecycleEventHandler as bC, type LinkFormat as bD, type MetricColor as bE, type MultiSelectFieldAdmin as bF, type NamedAccessPolicy as bG, type NumberFieldAdmin as bH, type NumberFormat as bI, type NumberLimitFieldAdmin as bJ, type NumberLimitFieldConfig as bK, type NumericOperation as bL, type OIDCAdminAuthProvider as bM, type OptionFormat as bN, type PaginatedResult as bO, type PublicAdminAuthProvider as bP, type RadioFieldAdmin as bQ, type RateLimitConfig as bR, type ReadonlyDatabaseAdapter as bS, type RichTextFeature as bT, type RichTextFieldConfig as bU, type SelectFieldAdmin as bV, type SqlWhereResult as bW, type StorageAdapter as bX, type TextFieldAdmin as bY, type TextFormat as bZ, type TextareaFieldAdmin as b_, type FieldAdminOptionsHook as ba, type FieldAdminOptionsHookArgs as bb, type FieldAdminOptionsHookResult as bc, type FieldAfterReadHook as bd, type FieldAfterReadHookArgs as be, type FieldBase as bf, type FieldBeforeChangeHook as bg, type FieldBeforeChangeHookArgs as bh, type FieldHook as bi, type FieldHooks as bj, type FieldType as bk, type FileData as bl, type GlobalAfterChangeHook as bm, type GlobalAfterReadHook as bn, type GlobalAfterReadHookEntry as bo, type GlobalBeforeChangeHook as bp, type GlobalBeforeChangeHookEntry as bq, type GlobalBeforeReadHook as br, type GlobalBeforeReadHookEntry as bs, type HeadingLevel as bt, type HookFunction as bu, type IconFieldAdmin as bv, type ImageService as bw, type InferAggregateResult as bx, type JoinFieldAdmin as by, type JsonFieldAdmin as bz, type WorkflowTransition as c, type TypedField as c0, type UploadConfig as c1, type UrlFieldAdmin as c2, type UrlLinkValue as c3, type ViewActionFeatures as c4, type ViewComponentSlots as c5, type ViewConfig as c6, type ViewLayout as c7, type ViewMetric as c8, type ViewSubMetric as c9, type WhereClause as ca, type WhereOperator as cb, type WhereOperatorName as cc, type WordLimitFieldAdmin as cd, type WordLimitFieldConfig as ce, type WorkflowMetadata as cf, type WorkflowRole as cg, type WorkflowState as ch, type WorkflowTransitionContext as ci, defineAction as cj, defineView as ck, parseMongoWhere as cl, parseSqlWhere as cm, type LifecycleEvent as d, type BaseDocument as e, type DetailComputedOptions as f, type ComputedHandler as g, type DetailComputed as h, type DetailCustomOptions as i, type DetailCustom as j, type DetailDividerOptions as k, type DetailDivider as l, type DisplayFieldOptions as m, type DetailField as n, type DetailItem as o, type DetailGridOptions as p, type DetailGrid as q, type DetailRepeatOptions as r, type DetailRepeat as s, type DetailSectionOptions as t, type DetailSection as u, type DetailTabOptions as v, type DetailTab as w, type DetailTabsOptions as x, type DetailTabs as y, type DetailTextOptions as z };
+interface CollectionTokenPayload extends JWTPayload {
+    sub: string;
+    email: string;
+    collection: string;
+    sid?: string;
+    purpose?: 'invite' | 'reset';
+    providerId?: string;
+    authSource?: 'local' | 'external';
+}
+
+type RequestVars = DyrectedContext["Variables"];
+interface ResolvedObservabilityConfig {
+    requestLogging: {
+        enabled: boolean;
+        logBodies: boolean;
+        maxBodyBytes: number;
+        redactPaths: string[];
+        includeHeaders: string[];
+        redactHeaders: string[];
+    };
+    sampling: {
+        successRate: number;
+        traceSuccessRate: number;
+        bodySuccessRate: number;
+        alwaysKeep4xx: boolean;
+        alwaysKeep5xx: boolean;
+    };
+    tracing: {
+        enabled: boolean;
+        serviceName: string;
+        exporter: "otlp" | "console" | "none";
+        headers: Record<string, string>;
+        endpoint?: string;
+    };
+    metrics: {
+        enabled: boolean;
+        exporter: "otlp" | "prometheus" | "none";
+        endpoint?: string;
+        path: string;
+    };
+    transports: {
+        targets: Array<{
+            type: "stdout";
+        } | {
+            type: "stderr";
+        } | {
+            type: "file";
+            path: string;
+        } | {
+            type: "otlp";
+            endpoint: string;
+            headers?: Record<string, string>;
+        }>;
+    };
+}
+interface RequestTraceContext {
+    span: Span;
+    traceId: string;
+    spanId: string;
+    sampled: boolean;
+}
+interface RequestBodyCapture {
+    attempted: boolean;
+    contentType?: string;
+    contentLength?: number;
+    truncated?: boolean;
+    parseFailed?: boolean;
+    body?: unknown;
+}
+interface MetricsRuntime {
+    requestCount: Counter<Attributes>;
+    authFailureCount: Counter<Attributes>;
+    uncaughtErrorCount: Counter<Attributes>;
+    auditWriteFailureCount: Counter<Attributes>;
+    emailSendFailureCount: Counter<Attributes>;
+    workflowHookFailureCount: Counter<Attributes>;
+    requestDuration: Histogram<Attributes>;
+}
+interface DyrectedObservabilityRuntime {
+    logger: Logger;
+    config: ResolvedObservabilityConfig;
+    tracer?: Tracer;
+    metrics?: MetricsRuntime;
+    prometheusExporter?: PrometheusExporter;
+    shutdown: () => Promise<void>;
+    recordAuthFailure: (attributes?: Attributes) => void;
+    recordUncaughtError: (attributes?: Attributes) => void;
+    recordAuditWriteFailure: (attributes?: Attributes) => void;
+    recordEmailSendFailure: (attributes?: Attributes) => void;
+    recordWorkflowHookFailure: (attributes?: Attributes) => void;
+}
+declare function resolveObservabilityConfig(config?: DyrectedObservabilityConfig): ResolvedObservabilityConfig;
+declare function createObservabilityRuntime(config: DyrectedConfig): DyrectedObservabilityRuntime;
+declare function bindObservabilityRuntime(config: DyrectedConfig, runtime: DyrectedObservabilityRuntime): void;
+declare function getObservabilityRuntime(config: Pick<DyrectedConfig, "logger"> | undefined): DyrectedObservabilityRuntime | undefined;
+declare function getConfigLogger(config: Pick<DyrectedConfig, "logger"> | undefined, component: string): Logger;
+declare function getRequestLogger(c: Context<DyrectedContext>, component?: string): Logger;
+declare function buildRequestLogger(runtime: DyrectedObservabilityRuntime, vars: RequestVars, requestId?: string): Logger;
+declare function shouldSampleRequest(requestId: string | undefined, statusCode: number, sampling: ResolvedObservabilityConfig["sampling"], kind: "log" | "trace" | "body"): boolean;
+declare function redactHeaders(headers: Record<string, string>, observability: ResolvedObservabilityConfig): Record<string, string>;
+declare function captureRequestBody(request: Request, observability: ResolvedObservabilityConfig): Promise<RequestBodyCapture>;
+declare function redactBody(value: unknown, redactPaths: string[]): unknown;
+declare function createRequestSpan(runtime: DyrectedObservabilityRuntime, name: string, attributes: Attributes): RequestTraceContext | undefined;
+declare function endRequestSpan(requestTrace: RequestTraceContext | undefined, statusCode: number, error?: unknown): void;
+declare function attachRequestMetrics(runtime: DyrectedObservabilityRuntime, args: {
+    method: string;
+    route: string;
+    statusCode: number;
+    durationMs: number;
+}): void;
+declare function renderPrometheusMetrics(exporter: PrometheusExporter): Promise<{
+    body: string;
+    headers: Record<string, string>;
+    statusCode: number;
+}>;
+
+interface DyrectedContext {
+    Variables: {
+        config: DyrectedConfig;
+        logger?: Logger;
+        observability?: DyrectedObservabilityRuntime;
+        siteId?: string;
+        workspaceId?: string;
+        requestBodyCapture?: RequestBodyCapture;
+        requestTrace?: RequestTraceContext;
+        /**
+         * The authenticated user set by requireAuth() or optionalAuth() middleware.
+         * Hydrated from the full user record (minus password) when a db adapter is
+         * configured, so collection fields like `roles` are available; falls back to
+         * the token's identity claims otherwise.
+         */
+        user?: {
+            sub: string;
+            email?: string;
+            collection: string;
+            [key: string]: any;
+        };
+        clientIp?: string;
+        authTokenPayload?: CollectionTokenPayload;
+    };
+}
+/**
+ * Create the main Dyrected Hono application.
+ */
+declare function createDyrectedApp(rawConfig: DyrectedConfig | any): Promise<Hono<DyrectedContext, hono_types.BlankSchema, "/">>;
+
+export { type MultiSelectField as $, type AdminAuthConfig as A, type Block as B, type CollectionConfig as C, type DyrectedConfig as D, type DetailText as E, type Field as F, type GlobalConfig as G, type HookRequestContext as H, type DetailSchema as I, type DyrectedContext as J, type AIConfig as K, type LifecycleEventName as L, type AIPIIConfig as M, type ArrayField as N, type BlocksField as O, type PublicAdminAuthConfig as P, type BooleanField as Q, type AuthConfig as R, type AccessPolicyResolver as S, type DateField as T, type DateTimeField as U, type EmailField as V, type WorkflowConfig as W, type IconField as X, type ImageField as Y, type JoinField as Z, type JsonField as _, type DeclarativeHookExpression as a, type CollectionAfterReadHook as a$, type NumberField as a0, type ObjectField as a1, type RadioField as a2, type RelationshipField as a3, type RichTextField as a4, type RowField as a5, type SelectField as a6, type TextField as a7, type TextareaField as a8, type TimeField as a9, type ActionType as aA, type AdminAuthAccessResolution as aB, type AdminAuthClaimMapping as aC, type AdminAuthMember as aD, type AdminAuthProvider as aE, type AdminAuthProviderMembersConfig as aF, type AdminAuthProvisioningMode as aG, type AdminAuthResolveAccessArgs as aH, type AdminAuthResolvedIdentity as aI, type AdminConfig as aJ, type AdminDashboardComponentSlots as aK, type AdminIconName as aL, type AggregateArgs as aM, type AggregateCastType as aN, type AggregateCollectionResult as aO, type AggregateInput as aP, type AggregateOperation as aQ, type AggregateResult as aR, type BaseAdminAuthProvider as aS, type BaseFieldAdmin as aT, type BlockVariant as aU, type BooleanFieldAdmin as aV, type BooleanFormat as aW, type CharacterLimitFieldAdmin as aX, type CharacterLimitFieldConfig as aY, type CollectionAfterChangeHook as aZ, type CollectionAfterDeleteHook as a_, type UrlField as aa, type AIAction as ab, type AIActionStatus as ac, type AIActionType as ad, type AIAuditActionType as ae, type AIAuditRecord as af, type AIChunk as ag, type AIMessage as ah, type AIPIIPattern as ai, type AIRateLimitResult as aj, type AIRateLimitStore as ak, type AIThread as al, type AIToolContext as am, type AIToolDefinition as an, AI_ACTIONS_COLLECTION as ao, AI_AUDIT_COLLECTION as ap, AI_CHUNKS_COLLECTION as aq, AI_MESSAGES_COLLECTION as ar, AI_THREADS_COLLECTION as as, type AccessConfig as at, type AccessFunction as au, type AccessFunctionArgs as av, type AccessResult as aw, type AccessRule as ax, type ActionConfig as ay, type ActionContext as az, type AuthenticatedUser as b, type ImageTransformOptions as b$, type CollectionAfterReadHookEntry as b0, type CollectionAfterTransitionHook as b1, type CollectionBeforeChangeHook as b2, type CollectionBeforeChangeHookEntry as b3, type CollectionBeforeDeleteHook as b4, type CollectionBeforeReadHook as b5, type CollectionBeforeReadHookEntry as b6, type CollectionBeforeTransitionHook as b7, type CollectionListComponentSlots as b8, type CollectionRAGConfig as b9, type FieldAdminOptionsHook as bA, type FieldAdminOptionsHookArgs as bB, type FieldAdminOptionsHookResult as bC, type FieldAfterReadHook as bD, type FieldAfterReadHookArgs as bE, type FieldBase as bF, type FieldBeforeChangeHook as bG, type FieldBeforeChangeHookArgs as bH, type FieldHook as bI, type FieldHooks as bJ, type FieldType as bK, type FileData as bL, type GetDocumentResult as bM, type GlobalAfterChangeHook as bN, type GlobalAfterReadHook as bO, type GlobalAfterReadHookEntry as bP, type GlobalBeforeChangeHook as bQ, type GlobalBeforeChangeHookEntry as bR, type GlobalBeforeReadHook as bS, type GlobalBeforeReadHookEntry as bT, type GlobalRAGConfig as bU, type GlobalSchemaResult as bV, type GlobalSummaryResult as bW, type HeadingLevel as bX, type HookFunction as bY, type IconFieldAdmin as bZ, type ImageService as b_, type CollectionSchemaResult as ba, type CollectionSummaryResult as bb, type CollectionViewComponentSlots as bc, type CountOperation as bd, type CustomAdminAuthProvider as be, type DatabaseAdapter as bf, type DateFieldAdmin as bg, type DateFormat as bh, type DefineActionOptions as bi, type DefineViewOptions as bj, type DetailSpan as bk, type DisplayTone as bl, type DisplayVariant as bm, type DistinctCountOperation as bn, type DistinctValuesOperation as bo, type DynamicOptionItem as bp, type DynamicOptionsConfig as bq, type DynamicOptionsResolver as br, type DynamicOptionsResolverArgs as bs, type DyrectedAIContext as bt, type DyrectedLoggerConfig as bu, type DyrectedObservabilityConfig as bv, type EmailFieldAdmin as bw, type FieldAdminHooks as bx, type FieldAdminOnChangeHook as by, type FieldAdminOnChangeHookArgs as bz, type WorkflowTransition as c, buildRequestLogger as c$, type InferAggregateResult as c0, type JoinFieldAdmin as c1, type JsonFieldAdmin as c2, type JsonFormat as c3, LIFECYCLE_EVENT_NAMES as c4, type LifecycleEventHandler as c5, type LinkFormat as c6, type MetricColor as c7, type MultiSelectFieldAdmin as c8, type NamedAccessPolicy as c9, type UrlLinkValue as cA, type ViewActionFeatures as cB, type ViewComponentSlots as cC, type ViewConfig as cD, type ViewLayout as cE, type ViewMetric as cF, type ViewSubMetric as cG, type WhereClause as cH, type WhereOperator as cI, type WhereOperatorName as cJ, type WordLimitFieldAdmin as cK, type WordLimitFieldConfig as cL, type WorkflowMetadata as cM, type WorkflowRole as cN, type WorkflowState as cO, type WorkflowTransitionContext as cP, defineAction as cQ, defineView as cR, isAICollection as cS, parseMongoWhere as cT, parseSqlWhere as cU, type DyrectedObservabilityRuntime as cV, type RequestBodyCapture as cW, type RequestTraceContext as cX, type ResolvedObservabilityConfig as cY, attachRequestMetrics as cZ, bindObservabilityRuntime as c_, type NumberFieldAdmin as ca, type NumberFormat as cb, type NumberLimitFieldAdmin as cc, type NumberLimitFieldConfig as cd, type NumericOperation as ce, type OIDCAdminAuthProvider as cf, type OptionFormat as cg, type PaginatedResult as ch, type PublicAdminAuthProvider as ci, type QueryCollectionResult as cj, type RAGSearchResult as ck, type RadioFieldAdmin as cl, type RateLimitConfig as cm, type ReadonlyDatabaseAdapter as cn, type RichTextFeature as co, type RichTextFieldConfig as cp, type SelectFieldAdmin as cq, type SqlWhereResult as cr, type StorageAdapter as cs, type TextFieldAdmin as ct, type TextFormat as cu, type TextareaFieldAdmin as cv, type TrustProxyConfig as cw, type TypedField as cx, type UploadConfig as cy, type UrlFieldAdmin as cz, type LifecycleEvent as d, captureRequestBody as d0, createDyrectedApp as d1, createObservabilityRuntime as d2, createRequestSpan as d3, endRequestSpan as d4, getConfigLogger as d5, getObservabilityRuntime as d6, getRequestLogger as d7, redactBody as d8, redactHeaders as d9, renderPrometheusMetrics as da, resolveObservabilityConfig as db, shouldSampleRequest as dc, type BaseDocument as e, type DetailComputedOptions as f, type ComputedHandler as g, type DetailComputed as h, type DetailCustomOptions as i, type DetailCustom as j, type DetailDividerOptions as k, type DetailDivider as l, type DisplayFieldOptions as m, type DetailField as n, type DetailItem as o, type DetailGridOptions as p, type DetailGrid as q, type DetailRepeatOptions as r, type DetailRepeat as s, type DetailSectionOptions as t, type DetailSection as u, type DetailTabOptions as v, type DetailTab as w, type DetailTabsOptions as x, type DetailTabs as y, type DetailTextOptions as z };