adminizer 5.0.0-build.2 → 5.0.0-build.21

package/index.d.ts

@@ -1,58 +1,69 @@
-export * from "./helpers/configHelper";
-export * from "./helpers/accessRightsHelper";
-export * from "./lib/widgets/abstractAction";
-export * from "./lib/widgets/abstractInfo";
-export * from "./lib/widgets/abstractCustom";
-export * from "./lib/widgets/abstractLink";
-export * from "./lib/widgets/abstractWidgetBase";
-export * from "./lib/widgets/abstractSwitch";
-export * from "./lib/widgets/widgetHandler";
-export * from "./lib/catalog/AbstractCatalog";
-export * from "./lib/catalog/CatalogHandler";
-export * from "./lib/catalog/CatalogTemplateComponentHandler";
-export * from "./lib/media-manager/MediaManagerHandler";
-export * from "./controllers/media-manager/mediaManagerAdapter";
-export * from "./interfaces/adminpanelConfig";
-export * from "./interfaces/types";
-export * from "./interfaces/queryCriteria";
-export * from "./interfaces/listQueryBuilder";
-export * from "./interfaces/internalModelAccess";
-export * from "./interfaces/MaaterialIcons";
-export * from "./lib/model/AbstractModel";
-export * from "./lib/model/InternalModelAccessFactory";
-export * from "./system/systemModelContracts";
-export * from "./lib/model/adapter/sequelize";
-export * from "./lib/model/adapter/typeorm";
-export * from "./lib/media-manager/AbstractMediaManager";
-export * from "./lib/controls/Control";
-export * from "./lib/controls/ControlsHandler";
-export * from "./lib/Adminizer";
-export * from "./lib/I18n";
-export * from "./models/Group";
-export * from "./models/User";
-export * from "./models/Filter";
-export * from "./models/FilterColumn";
-export * from "./models/HistoryActions";
-export * from "./models/Notification";
-export * from "./models/UserNotification";
-export * from "./models/MediaManagerAP";
-export * from "./models/MediaManagerAssociationsAP";
-export * from "./models/MediaManagerMetaAP";
-export * from "./policies/authPolicies";
-export * from "./lib/helper/jwt";
-export * from "./lib/notifications/AbstractNotificationService";
-export * from "./lib/POWCaptcha";
-export * from "./lib/ai-assistant/AbstractAiModelService";
-export * from "./lib/ai-assistant/AiAssistantHandler";
-export * from "./lib/DataAccessor";
-export * from "./lib/history-actions/AbstractHistoryAdapter";
-export * from "./lib/filters/CustomFilterHandler";
-export * from "./lib/feedback/AbstractFeedbackHandler";
-export * from "./lib/feedback/FeedbackHandler";
-export * from "./lib/app-manager/AdminizerApp";
-export * from "./lib/app-manager/AppManager";
-export * from "./lib/app-manager/ControllerHandler";
-export * from "./lib/app-manager/AssetHandler";
-export * from "./lib/app-manager/ConfigLayerHandler";
-export * from "./lib/access-rights/AccessRightsHandler";
-export * from "./lib/media-manager/helpers/MediaManagerHelper";
+export * from "./helpers/configHelper.js";
+export * from "./helpers/accessRightsHelper.js";
+export * from "./lib/widgets/abstractAction.js";
+export * from "./lib/widgets/abstractInfo.js";
+export * from "./lib/widgets/abstractCustom.js";
+export * from "./lib/widgets/abstractLink.js";
+export * from "./lib/widgets/abstractWidgetBase.js";
+export * from "./lib/widgets/abstractSwitch.js";
+export * from "./lib/widgets/widgetHandler.js";
+export * from "./lib/catalog/AbstractCatalog.js";
+export * from "./lib/catalog/CatalogHandler.js";
+export * from "./lib/catalog/CatalogTemplateComponentHandler.js";
+export * from "./lib/media-manager/MediaManagerHandler.js";
+export * from "./controllers/media-manager/mediaManagerAdapter.js";
+export * from "./interfaces/adminpanelConfig.js";
+export * from "./interfaces/types.js";
+export * from "./interfaces/queryCriteria.js";
+export * from "./interfaces/listQueryBuilder.js";
+export * from "./interfaces/internalModelAccess.js";
+export * from "./interfaces/MaaterialIcons.js";
+export * from "./lib/model/AbstractModel.js";
+export * from "./lib/model/InternalModelAccessFactory.js";
+export * from "./system/systemModelContracts.js";
+export * from "./lib/model/adapter/sequelize.js";
+export * from "./lib/model/adapter/typeorm.js";
+export * from "./lib/media-manager/AbstractMediaManager.js";
+export * from "./lib/controls/Control.js";
+export * from "./lib/controls/ControlsHandler.js";
+export * from "./lib/Adminizer.js";
+export * from "./lib/docs/AbstractDocumentation.js";
+export * from "./lib/docs/DocumentationHandler.js";
+export * from "./lib/docs/FileDocumentation.js";
+export * from "./lib/I18n.js";
+export * from "./models/Group.js";
+export * from "./models/User.js";
+export * from "./models/Filter.js";
+export * from "./models/FilterColumn.js";
+export * from "./models/HistoryActions.js";
+export * from "./models/Notification.js";
+export * from "./models/UserNotification.js";
+export * from "./models/MediaManagerAP.js";
+export * from "./models/MediaManagerAssociationsAP.js";
+export * from "./models/MediaManagerMetaAP.js";
+export * from "./policies/authPolicies.js";
+export * from "./lib/helper/jwt.js";
+export * from "./lib/notifications/AbstractNotificationService.js";
+export * from "./lib/POWCaptcha.js";
+export * from "./lib/ai-assistant/AbstractAiModelService.js";
+export * from "./lib/ai-assistant/AbstractAiConversationHistoryService.js";
+export * from "./lib/ai-assistant/AiAssistantHandler.js";
+export * from "./lib/ai-assistant/AiAgentRunManager.js";
+export * from "./lib/ai-assistant/jsonSafe.js";
+export * from "./lib/ai-assistant/AiAssistantUiMethodHandler.js";
+export * from "./lib/ai-assistant/AiAssistantAgentSkillHandler.js";
+export * from "./lib/admin-links/AdminLinkHandler.js";
+export * from "./helpers/modelResourceHelper.js";
+export * from "./helpers/navigationAccessHelper.js";
+export * from "./lib/DataAccessor.js";
+export * from "./lib/history-actions/AbstractHistoryAdapter.js";
+export * from "./lib/filters/CustomFilterHandler.js";
+export * from "./lib/feedback/AbstractFeedbackHandler.js";
+export * from "./lib/feedback/FeedbackHandler.js";
+export * from "./lib/app-manager/AdminizerApp.js";
+export * from "./lib/app-manager/AppManager.js";
+export * from "./lib/app-manager/ControllerHandler.js";
+export * from "./lib/app-manager/AssetHandler.js";
+export * from "./lib/app-manager/ConfigLayerHandler.js";
+export * from "./lib/access-rights/AccessRightsHandler.js";
+export * from "./lib/media-manager/helpers/MediaManagerHelper.js";

package/index.js

@@ -27,6 +27,9 @@ export * from "./lib/media-manager/AbstractMediaManager.js";
 export * from "./lib/controls/Control.js";
 export * from "./lib/controls/ControlsHandler.js";
 export * from "./lib/Adminizer.js";
+export * from "./lib/docs/AbstractDocumentation.js";
+export * from "./lib/docs/DocumentationHandler.js";
+export * from "./lib/docs/FileDocumentation.js";
 export * from "./lib/I18n.js";
 export * from "./models/Group.js";
 export * from "./models/User.js";
@@ -43,7 +46,15 @@ export * from "./lib/helper/jwt.js";
 export * from "./lib/notifications/AbstractNotificationService.js";
 export * from "./lib/POWCaptcha.js";
 export * from "./lib/ai-assistant/AbstractAiModelService.js";
+export * from "./lib/ai-assistant/AbstractAiConversationHistoryService.js";
 export * from "./lib/ai-assistant/AiAssistantHandler.js";
+export * from "./lib/ai-assistant/AiAgentRunManager.js";
+export * from "./lib/ai-assistant/jsonSafe.js";
+export * from "./lib/ai-assistant/AiAssistantUiMethodHandler.js";
+export * from "./lib/ai-assistant/AiAssistantAgentSkillHandler.js";
+export * from "./lib/admin-links/AdminLinkHandler.js";
+export * from "./helpers/modelResourceHelper.js";
+export * from "./helpers/navigationAccessHelper.js";
 export * from "./lib/DataAccessor.js";
 export * from "./lib/history-actions/AbstractHistoryAdapter.js";
 export * from "./lib/filters/CustomFilterHandler.js";

package/interfaces/adminpanelConfig.d.ts

@@ -1,9 +1,9 @@
-import { MaterialIcon } from "./MaaterialIcons";
+import { MaterialIcon } from "./MaaterialIcons.js";
 import { EditorOptions } from "@toast-ui/editor/types/editor";
 import { GridSettings as HandsontableSettings } from "handsontable/settings";
-import { Group } from "../models/Group";
-import { User } from "../models/User";
-import { InternalModelAccessMap } from "./internalModelAccess";
+import { Group } from "../models/Group.js";
+import { User } from "../models/User.js";
+import { InternalModelAccessMap } from "./internalModelAccess.js";
 /**
  * Controller function type - async function that handles requests and returns a response
  */
@@ -223,6 +223,14 @@ export interface AdminpanelConfig {
         defaultModel?: string;
         models?: string[];
     };
+    /**
+     * Knowledge base (built-in documentation). The implementation is
+     * registered separately: `adminizer.documentationHandler.register(service)`.
+     */
+    documentation?: {
+        /** Master switch of the subsystem; nothing is brought up unless `true` */
+        enabled?: boolean;
+    };
     cors?: {
         enabled: boolean;
         origin: string[] | string;
@@ -299,9 +307,14 @@ export interface ModelConfig {
     adapter?: string;
     title: string;
     /**
-     * Model name
+     * Physical host ORM model name.
      * */
     model: string;
+    /**
+     * Required only when two or more Adminizer resources use the same host model.
+     * The primary resource is selected for associations that reference the host model.
+     */
+    primary?: boolean;
     /**
      * Optional display name for history. Should be a attribute of the model, or a function.
      */

package/interfaces/global.d.ts

@@ -1,11 +1,11 @@
-import { Adminizer } from "../lib/Adminizer";
+import { Adminizer } from "../lib/Adminizer.js";
 import { NextFunction, Request, Response } from "express";
 import multer from "multer";
-import { I18n } from "../lib/I18n";
-import { Inertia } from "../lib/inertia/inertiaAdapter";
-import { Flash } from "../lib/inertia/flash";
-import { User } from "../models/User";
-import { AppRuntime } from "../lib/app-manager/AdminizerApp";
+import { I18n } from "../lib/I18n.js";
+import { Inertia } from "../lib/inertia/inertiaAdapter.js";
+import { Flash } from "../lib/inertia/flash.js";
+import { User } from "../models/User.js";
+import { AppRuntime } from "../lib/app-manager/AdminizerApp.js";
 declare global {
     /** @deprecated use import from TS model decalration */
     type ModelsAP = {

package/interfaces/internalModelAccess.d.ts

@@ -1,4 +1,4 @@
-import { IsAny, QueryCriteria } from "./queryCriteria";
+import { IsAny, QueryCriteria } from "./queryCriteria.js";
 export type InternalModelAccessScope = string;
 export type InternalModelAccessMap = Record<InternalModelAccessScope, string[]>;
 export type InternalModelRelationId = string | number;

package/interfaces/listQueryBuilder.d.ts

@@ -1,4 +1,4 @@
-import { FilterCondition } from "../models/Filter";
+import { FilterCondition } from "../models/Filter.js";
 /**
  * Input format for list/feed/export query builder.
  * This is not the internal model query language.

package/interfaces/types.d.ts

@@ -1,5 +1,6 @@
-import { AbstractModel } from "../lib/model/AbstractModel";
-import { ModelConfig } from "./adminpanelConfig";
+import { AbstractModel } from "../lib/model/AbstractModel.js";
+import { ModelConfig } from "./adminpanelConfig.js";
+import type { User } from "../models/User.js";
 export interface ModelResource {
     name: string;
     config?: ModelConfig;
@@ -11,7 +12,24 @@ export interface AccessRightsToken {
     description: string;
     department: string;
     id: string;
+    getOptions?: (user: User) => Promise<PermissionOption[]>;
+    check?: (user: User, context?: PermissionContext) => Promise<boolean>;
 }
+export interface PermissionOption {
+    id: string;
+    name: string;
+    description?: string;
+}
+export interface PermissionContext {
+    rights?: string[];
+    [key: string]: unknown;
+}
+/** Serialized as a JSON string in Group.tokens for a contextual token. */
+export interface GroupPermissionGrant {
+    tokenId: string;
+    rights: string[];
+}
+export type PermissionGrant = string | GroupPermissionGrant;
 export interface PropsField {
     label: string;
     type: string;
@@ -70,3 +88,154 @@ export interface AiAssistantModelInfo {
     name: string;
     description?: string;
 }
+/**
+ * Streaming agent contract.
+ *
+ * A model service that only implements `generateReply` stays a plain chat
+ * model; services that also implement the optional agent members below are
+ * driven by the streaming UI (tool calls, reasoning, attachments, per-user
+ * server-side session). See AbstractAiModelService.
+ */
+/** One SSE frame of a run. `type` drives how the UI folds it into the thread. */
+export type AiAgentStreamEvent = {
+    type: 'text.delta' | 'text.done' | 'reasoning.delta' | 'reasoning.done' | 'tool.start' | 'tool.done' | 'tool.error' | 'step.done' | 'turn.done' | 'done' | 'error' | string;
+    [key: string]: unknown;
+};
+export type AiAgentPublish = (event: AiAgentStreamEvent) => void;
+export interface AiAgentTokenUsage {
+    inputTokens?: number;
+    outputTokens?: number;
+    totalTokens?: number;
+}
+/** One selectable LLM inside an agent service. */
+export interface AiAgentModelOption {
+    id: string;
+    contextWindow: number | null;
+    maxOutputTokens: number | null;
+    vision: boolean;
+    /** Relative spend multiplier (×1 = median-priced model); null if unknown. */
+    costCoefficient: number | null;
+    [key: string]: unknown;
+}
+/** State of the user's server-side agent session. */
+export interface AiAgentSessionMeta {
+    model: string;
+    contextWindow: number;
+    vision: boolean;
+    turns: number;
+    contextTokens: number;
+    totalUsage: AiAgentTokenUsage;
+    [key: string]: unknown;
+}
+/**
+ * Whether the service can talk to its LLM yet. Services that need no
+ * provisioning simply omit `getConnectionStatus()` and are treated as ready.
+ */
+export interface AiAgentConnectionStatus {
+    state: 'ready' | 'registering' | 'waiting_retry' | 'setup_required' | 'error';
+    provider?: string;
+    baseUrl?: string;
+    source?: string | null;
+    nextAttemptAt?: string | null;
+    lastError?: string | null;
+    expiresAt?: string | null;
+    [key: string]: unknown;
+}
+/** States for which an agent can describe its connection screen. */
+export type AiAgentConnectionState = Exclude<AiAgentConnectionStatus['state'], 'ready'>;
+/**
+ * Declarative connection screen supplied by an agent service. The shared panel
+ * owns rendering, while the agent owns its copy, CTA and which status details
+ * are useful to expose.
+ */
+export interface AiAgentConnectionScreen {
+    title?: string;
+    description?: string;
+    icon?: 'spinner' | 'bot' | 'error';
+    action?: {
+        label: string;
+        href: string;
+    };
+    /** Status values the agent wants to render on this screen. */
+    details?: Array<{
+        field: string;
+        label?: string;
+        format?: 'text' | 'local-time';
+        tone?: 'muted' | 'error';
+    }>;
+}
+/** Normalized budget / rate limits of the provider key, when it exposes them. */
+export interface AiAgentLimits {
+    provider: string;
+    supported: boolean;
+    overBudget?: boolean;
+    message?: string;
+    maxBudgetUsd?: number | null;
+    spentUsd?: number | null;
+    remainingBudgetUsd?: number | null;
+    budgetResetAt?: string | null;
+    burstMaxBudgetUsd?: number | null;
+    burstSpentUsd?: number | null;
+    burstRemainingBudgetUsd?: number | null;
+    burstResetAt?: string | null;
+    burstDurationLabel?: string | null;
+    rpmLimit?: number | null;
+    tpmLimit?: number | null;
+    fetchedAt?: string;
+    [key: string]: unknown;
+}
+/**
+ * Copy the panel shows instead of its neutral defaults. `getUiHints(locale)`
+ * receives the admin user's locale, so agents can return localized copy.
+ */
+export interface AiAgentUiHints {
+    title?: string;
+    welcomeHint?: string;
+    composerPlaceholder?: string;
+    suggestions?: string[];
+    /** Setting an operator must fill in before the service can connect. */
+    setupSetting?: string;
+    /** Where to fill it in; rendered as a button on the connection loader. */
+    setupUrl?: string;
+    /**
+     * Per-state pages rendered while this agent is not ready. `default` is
+     * used for any state without its own screen.
+     */
+    connectionScreens?: Partial<Record<AiAgentConnectionState | 'default', AiAgentConnectionScreen>>;
+    [key: string]: unknown;
+}
+/** A browser-side capability which an agent may call through `ui.method`. */
+export interface AiAgentUiMethod {
+    id: string;
+    title: string;
+    description: string;
+    inputSchema: Record<string, unknown>;
+    action: string;
+    accessRightsToken?: string;
+}
+/** Declarative UI contract consumed by the shared assistant panel. */
+export interface AiAgentUiSchema extends AiAgentUiHints {
+    commands: Array<{
+        id: string;
+        description?: string;
+    }>;
+    uiMethods?: AiAgentUiMethod[];
+    panels: {
+        history: boolean;
+        models: boolean;
+        limits: boolean;
+    };
+}
+/** An uploaded file as handed to the agent service (multer memory storage). */
+export interface AiAgentUploadedFile {
+    originalname: string;
+    mimetype: string;
+    size: number;
+    buffer: Buffer;
+}
+/** What the service reports back about a stored upload, if it stores them. */
+export interface AiAgentSavedFile {
+    id?: string;
+    name?: string;
+    [key: string]: unknown;
+}

package/lib/Adminizer.d.ts

@@ -1,32 +1,36 @@
 import express, { Express } from "express";
 import winston from "winston";
 import EventEmitter from 'events';
-import { AdminpanelConfig } from "../interfaces/adminpanelConfig";
-import MiddlewareManager from "./MiddlewareManager";
-import Router from "./../system/Router";
-import { ModelHandler } from "./model/ModelHandler";
-import { WidgetHandler } from "./widgets/widgetHandler";
-import { AccessRightsHelper } from "../helpers/accessRightsHelper";
-import { ConfigHelper } from "../helpers/configHelper";
-import { I18n } from "./I18n";
-import { AbstractAdapter } from "./model/AbstractModel";
+import { AdminpanelConfig } from "../interfaces/adminpanelConfig.js";
+import MiddlewareManager from "./MiddlewareManager.js";
+import Router from "./../system/Router.js";
+import { ModelHandler } from "./model/ModelHandler.js";
+import { WidgetHandler } from "./widgets/widgetHandler.js";
+import { AccessRightsHelper } from "../helpers/accessRightsHelper.js";
+import { ConfigHelper } from "../helpers/configHelper.js";
+import { I18n } from "./I18n.js";
+import { AbstractAdapter } from "./model/AbstractModel.js";
 import type { ViteDevServer } from 'vite';
-import { MenuHelper } from "../helpers/menuHelper";
-import { ControlsHandler } from "./controls/ControlsHandler";
-import { CatalogHandler } from "./catalog/CatalogHandler";
-import { CatalogTemplateComponentHandler } from "./catalog/CatalogTemplateComponentHandler";
-import { AiAssistantHandler } from './ai-assistant/AiAssistantHandler';
-import { NotificationHandler } from './notifications/NotificationHandler';
-import { INotification } from "../interfaces/types";
-import { MediaManagerHandler } from "./media-manager/MediaManagerHandler";
-import { HistoryHandler } from "./history-actions/HistoryHandler";
-import { CustomFilterHandler } from "./filters/CustomFilterHandler";
-import { FeedbackHandler } from "./feedback/FeedbackHandler";
-import { AppManager } from "./app-manager/AppManager";
-import { ControllerHandler } from "./app-manager/ControllerHandler";
-import { AssetHandler } from "./app-manager/AssetHandler";
-import { ConfigLayerHandler } from "./app-manager/ConfigLayerHandler";
-import { AccessRightsHandler } from "./access-rights/AccessRightsHandler";
+import { MenuHelper } from "../helpers/menuHelper.js";
+import { ControlsHandler } from "./controls/ControlsHandler.js";
+import { CatalogHandler } from "./catalog/CatalogHandler.js";
+import { CatalogTemplateComponentHandler } from "./catalog/CatalogTemplateComponentHandler.js";
+import { AiAssistantHandler } from './ai-assistant/AiAssistantHandler.js';
+import { NotificationHandler } from './notifications/NotificationHandler.js';
+import { INotification } from "../interfaces/types.js";
+import { MediaManagerHandler } from "./media-manager/MediaManagerHandler.js";
+import { HistoryHandler } from "./history-actions/HistoryHandler.js";
+import { CustomFilterHandler } from "./filters/CustomFilterHandler.js";
+import { FeedbackHandler } from "./feedback/FeedbackHandler.js";
+import { AppManager } from "./app-manager/AppManager.js";
+import { ControllerHandler } from "./app-manager/ControllerHandler.js";
+import { AssetHandler } from "./app-manager/AssetHandler.js";
+import { ConfigLayerHandler } from "./app-manager/ConfigLayerHandler.js";
+import { AccessRightsHandler } from "./access-rights/AccessRightsHandler.js";
+import { AiAssistantUiMethodHandler } from './ai-assistant/AiAssistantUiMethodHandler.js';
+import { AdminLinkHandler } from './admin-links/AdminLinkHandler.js';
+import { AiAssistantAgentSkillHandler } from './ai-assistant/AiAssistantAgentSkillHandler.js';
+import { DocumentationHandler } from './docs/DocumentationHandler.js';
 export declare function createAdminizerLogger(): winston.Logger;
 export interface EmitAsyncOptions {
     /**
@@ -53,7 +57,11 @@ export declare class Adminizer {
     router: Router;
     notificationHandler: NotificationHandler;
     historyHandler: HistoryHandler;
-    aiAssistantHandler?: AiAssistantHandler;
+    private _aiAssistantHandler?;
+    aiAssistantUiMethodHandler: AiAssistantUiMethodHandler;
+    adminLinkHandler: AdminLinkHandler;
+    aiAssistantAgentSkillHandler: AiAssistantAgentSkillHandler;
+    documentationHandler: DocumentationHandler;
     modelHandler: ModelHandler;
     widgetHandler: WidgetHandler;
     customFilterHandler: CustomFilterHandler;
@@ -71,6 +79,18 @@ export declare class Adminizer {
     jwtSecret: string;
     static logger: winston.Logger;
     constructor(ormAdapters: AbstractAdapter[]);
+    /**
+     * Shared AI assistant model registry.
+     *
+     * Created lazily on first access, so host code can register models
+     * directly (`adminizer.aiAssistantHandler.registerModel(service)`) without
+     * declaring an app. Apps register their models in the same handler through
+     * `ctx.aiAssistant()` and own only their entries.
+     * `config.aiAssistant.enabled` stays a gate for controllers and the UI, not
+     * for the registry itself.
+     */
+    get aiAssistantHandler(): AiAssistantHandler;
+    set aiAssistantHandler(handler: AiAssistantHandler | undefined);
     getMiddleware(): (req: express.Request, res: express.Response, next: () => void) => void;
     /**
      * Vite middleware

package/lib/Adminizer.js

@@ -30,6 +30,7 @@ import { ControlsHandler } from "./controls/ControlsHandler.js";
 import { CatalogHandler } from "./catalog/CatalogHandler.js";
 import { CatalogTemplateComponentHandler } from "./catalog/CatalogTemplateComponentHandler.js";
 import { v4 as uuid } from "uuid";
+import { AiAssistantHandler } from './ai-assistant/AiAssistantHandler.js';
 import { bindNotifications } from "../system/bindNotifications.js";
 import { MediaManagerHandler } from "./media-manager/MediaManagerHandler.js";
 import { bindCors } from "../system/bindCors.js";
@@ -42,6 +43,11 @@ import { ControllerHandler } from "./app-manager/ControllerHandler.js";
 import { AssetHandler } from "./app-manager/AssetHandler.js";
 import { ConfigLayerHandler } from "./app-manager/ConfigLayerHandler.js";
 import { AccessRightsHandler } from "./access-rights/AccessRightsHandler.js";
+import { AiAssistantUiMethodHandler } from './ai-assistant/AiAssistantUiMethodHandler.js';
+import { AdminLinkHandler } from './admin-links/AdminLinkHandler.js';
+import { AiAssistantAgentSkillHandler } from './ai-assistant/AiAssistantAgentSkillHandler.js';
+import { DocumentationHandler } from './docs/DocumentationHandler.js';
+import bindDocs from '../system/bindDocs.js';
 const logFilePath = "logs/app.log";
 function ensureLogDirectory(filePath) {
     const logDirectory = path.dirname(filePath);
@@ -107,7 +113,11 @@ export class Adminizer {
     router;
     notificationHandler;
     historyHandler;
-    aiAssistantHandler;
+    _aiAssistantHandler;
+    aiAssistantUiMethodHandler;
+    adminLinkHandler;
+    aiAssistantAgentSkillHandler;
+    documentationHandler;
     modelHandler;
     widgetHandler;
     customFilterHandler;
@@ -140,11 +150,32 @@ export class Adminizer {
         this.catalogTemplateComponentHandler = new CatalogTemplateComponentHandler();
         this.mediaManagerHandler = new MediaManagerHandler();
         this.feedbackHandler = new FeedbackHandler(this);
+        this.aiAssistantUiMethodHandler = new AiAssistantUiMethodHandler(this);
+        this.adminLinkHandler = new AdminLinkHandler(this);
+        this.aiAssistantAgentSkillHandler = new AiAssistantAgentSkillHandler(this);
+        this.documentationHandler = new DocumentationHandler(this, () => bindDocs(this));
         this.controllerHandler = new ControllerHandler(this);
         this.assetHandler = new AssetHandler(this);
         this.configLayerHandler = new ConfigLayerHandler(this);
         this.appManager = new AppManager(this);
     }
+    /**
+     * Shared AI assistant model registry.
+     *
+     * Created lazily on first access, so host code can register models
+     * directly (`adminizer.aiAssistantHandler.registerModel(service)`) without
+     * declaring an app. Apps register their models in the same handler through
+     * `ctx.aiAssistant()` and own only their entries.
+     * `config.aiAssistant.enabled` stays a gate for controllers and the UI, not
+     * for the registry itself.
+     */
+    get aiAssistantHandler() {
+        this._aiAssistantHandler ??= new AiAssistantHandler(this);
+        return this._aiAssistantHandler;
+    }
+    set aiAssistantHandler(handler) {
+        this._aiAssistantHandler = handler;
+    }
     getMiddleware() {
         return (req, res, next) => {
             try {
@@ -275,6 +306,11 @@ export class Adminizer {
             bindHistory(this);
         this.router = new Router(this);
         await this.router.bind(); // must be after binding policies and req/res functions
+        // Documentation (knowledge base) wires itself on register(); this call
+        // covers a service registered before the config was read. It runs after
+        // the router so those routes sit behind the same middleware stack a
+        // service registered after init() gets.
+        this.documentationHandler.activate();
         /**
          * Adminizer loaded
          * This call is used so that other apps can know that the admin panel is present in the panel and has been loaded, and can activate their logic.

package/lib/DataAccessor.d.ts

@@ -1,12 +1,12 @@
 /**
  * The class manages the interaction between the user and the database entry, taking into account user permissions and the main config file settings.
  */
-import { ModelResource } from "../interfaces/types";
-import { ActionType } from "../interfaces/adminpanelConfig";
-import { Fields } from "../helpers/fieldsHelper";
-import { Adminizer } from "./Adminizer";
-import { User } from "../models/User";
-import { QueryCriteria } from "../interfaces/queryCriteria";
+import { ModelResource } from "../interfaces/types.js";
+import { ActionType } from "../interfaces/adminpanelConfig.js";
+import { Fields } from "../helpers/fieldsHelper.js";
+import { Adminizer } from "./Adminizer.js";
+import { User } from "../models/User.js";
+import { QueryCriteria } from "../interfaces/queryCriteria.js";
 export declare class DataAccessor {
     readonly adminizer: Adminizer;
     user: User;
@@ -18,6 +18,7 @@ export declare class DataAccessor {
     private getModelConfig;
     private accessRelationModel;
     private resolveRelationTarget;
+    private getRelationModel;
     /**
      * Retrieves the fields for the given ModelResource based on action type,
      * taking into account access rights and configuration settings.