@directus/api 32.2.0 → 33.1.0

package/dist/ai/mcp/server.d.ts

@@ -25,6 +25,11 @@ export declare class DirectusMCP {
         content: ({
             type: "text";
             text: string;
+            annotations?: {
+                audience?: ("user" | "assistant")[] | undefined;
+                priority?: number | undefined;
+                lastModified?: string | undefined;
+            } | undefined;
             _meta?: {
                 [x: string]: unknown;
             } | undefined;
@@ -32,6 +37,11 @@ export declare class DirectusMCP {
             type: "image";
             data: string;
             mimeType: string;
+            annotations?: {
+                audience?: ("user" | "assistant")[] | undefined;
+                priority?: number | undefined;
+                lastModified?: string | undefined;
+            } | undefined;
             _meta?: {
                 [x: string]: unknown;
             } | undefined;
@@ -39,6 +49,11 @@ export declare class DirectusMCP {
             type: "audio";
             data: string;
             mimeType: string;
+            annotations?: {
+                audience?: ("user" | "assistant")[] | undefined;
+                priority?: number | undefined;
+                lastModified?: string | undefined;
+            } | undefined;
             _meta?: {
                 [x: string]: unknown;
             } | undefined;
@@ -48,6 +63,11 @@ export declare class DirectusMCP {
             type: "resource_link";
             description?: string | undefined;
             mimeType?: string | undefined;
+            annotations?: {
+                audience?: ("user" | "assistant")[] | undefined;
+                priority?: number | undefined;
+                lastModified?: string | undefined;
+            } | undefined;
             _meta?: {
                 [x: string]: unknown;
             } | undefined;
@@ -55,6 +75,7 @@ export declare class DirectusMCP {
                 src: string;
                 mimeType?: string | undefined;
                 sizes?: string[] | undefined;
+                theme?: "light" | "dark" | undefined;
             }[] | undefined;
             title?: string | undefined;
         } | {
@@ -74,14 +95,19 @@ export declare class DirectusMCP {
                     [x: string]: unknown;
                 } | undefined;
             };
+            annotations?: {
+                audience?: ("user" | "assistant")[] | undefined;
+                priority?: number | undefined;
+                lastModified?: string | undefined;
+            } | undefined;
             _meta?: {
                 [x: string]: unknown;
             } | undefined;
         })[];
         _meta?: {
             [x: string]: unknown;
+            progressToken?: string | number | undefined;
             "io.modelcontextprotocol/related-task"?: {
-                [x: string]: unknown;
                 taskId: string;
             } | undefined;
         } | undefined;

package/dist/ai/providers/index.d.ts

@@ -0,0 +1,3 @@
+export * from './types.js';
+export * from './registry.js';
+export * from './options.js';

package/dist/ai/providers/index.js

@@ -0,0 +1,3 @@
+export * from './types.js';
+export * from './registry.js';
+export * from './options.js';

package/dist/ai/providers/options.d.ts

@@ -0,0 +1,14 @@
+import { type ModelDefinition, type ProviderType } from '@directus/ai';
+import type { AISettings } from './types.js';
+export declare function getModelDefinition(provider: ProviderType, model: string, settings: AISettings): ModelDefinition | undefined;
+export declare function getProviderOptions(provider: ProviderType, model: string, settings: AISettings): {
+    openai: {
+        reasoningSummary: string;
+        store: boolean;
+        include: string[];
+    };
+} | {
+    [x: string]: {
+        [key: string]: import("@directus/ai").JSONValue;
+    };
+};

package/dist/ai/providers/options.js

@@ -0,0 +1,26 @@
+import { buildCustomModels, DEFAULT_AI_MODELS } from '@directus/ai';
+export function getModelDefinition(provider, model, settings) {
+    const customModels = buildCustomModels(settings.openaiCompatibleModels);
+    return [...DEFAULT_AI_MODELS, ...customModels].find((m) => m.provider === provider && m.model === model);
+}
+const OPENAI_REASONING_OPTIONS = {
+    openai: {
+        reasoningSummary: 'auto',
+        store: false,
+        include: ['reasoning.encrypted_content'],
+    },
+};
+export function getProviderOptions(provider, model, settings) {
+    const modelDef = getModelDefinition(provider, model, settings);
+    if (provider === 'openai' && modelDef?.reasoning) {
+        return OPENAI_REASONING_OPTIONS;
+    }
+    if (provider === 'openai-compatible') {
+        const customModel = settings.openaiCompatibleModels?.find((m) => m.id === model);
+        if (customModel?.providerOptions) {
+            const providerName = settings.openaiCompatibleName ?? 'openai-compatible';
+            return { [providerName]: customModel.providerOptions };
+        }
+    }
+    return {};
+}

package/dist/ai/providers/registry.d.ts

@@ -0,0 +1,6 @@
+import { createProviderRegistry } from 'ai';
+import type { AISettings, ProviderConfig } from './types.js';
+type ProviderRegistry = ReturnType<typeof createProviderRegistry>;
+export declare function buildProviderConfigs(settings: AISettings): ProviderConfig[];
+export declare function createAIProviderRegistry(configs: ProviderConfig[], settings?: AISettings): ProviderRegistry;
+export {};

package/dist/ai/providers/registry.js

@@ -0,0 +1,65 @@
+import { createAnthropic } from '@ai-sdk/anthropic';
+import { createGoogleGenerativeAI } from '@ai-sdk/google';
+import { createOpenAI } from '@ai-sdk/openai';
+import { createOpenAICompatible } from '@ai-sdk/openai-compatible';
+import { createProviderRegistry } from 'ai';
+export function buildProviderConfigs(settings) {
+    const configs = [];
+    if (settings.openaiApiKey) {
+        configs.push({
+            type: 'openai',
+            apiKey: settings.openaiApiKey,
+        });
+    }
+    if (settings.anthropicApiKey) {
+        configs.push({
+            type: 'anthropic',
+            apiKey: settings.anthropicApiKey,
+        });
+    }
+    if (settings.googleApiKey) {
+        configs.push({
+            type: 'google',
+            apiKey: settings.googleApiKey,
+        });
+    }
+    if (settings.openaiCompatibleApiKey && settings.openaiCompatibleBaseUrl) {
+        configs.push({
+            type: 'openai-compatible',
+            apiKey: settings.openaiCompatibleApiKey,
+            baseUrl: settings.openaiCompatibleBaseUrl,
+        });
+    }
+    return configs;
+}
+export function createAIProviderRegistry(configs, settings) {
+    const providers = {};
+    for (const config of configs) {
+        switch (config.type) {
+            case 'openai':
+                providers['openai'] = createOpenAI({ apiKey: config.apiKey });
+                break;
+            case 'anthropic':
+                providers['anthropic'] = createAnthropic({ apiKey: config.apiKey });
+                break;
+            case 'google':
+                providers['google'] = createGoogleGenerativeAI({ apiKey: config.apiKey });
+                break;
+            case 'openai-compatible':
+                if (config.baseUrl) {
+                    const customHeaders = settings?.openaiCompatibleHeaders?.reduce((acc, { header, value }) => {
+                        acc[header] = value;
+                        return acc;
+                    }, {}) ?? {};
+                    providers['openai-compatible'] = createOpenAICompatible({
+                        name: settings?.openaiCompatibleName ?? 'openai-compatible',
+                        apiKey: config.apiKey,
+                        baseURL: config.baseUrl,
+                        headers: customHeaders,
+                    });
+                }
+                break;
+        }
+    }
+    return createProviderRegistry(providers);
+}

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

@@ -0,0 +1,34 @@
+import type { OpenAICompatibleHeader, OpenAICompatibleModel } from '@directus/ai';
+interface OpenAIConfig {
+    type: 'openai';
+    apiKey: string;
+}
+interface AnthropicConfig {
+    type: 'anthropic';
+    apiKey: string;
+}
+interface GoogleConfig {
+    type: 'google';
+    apiKey: string;
+}
+interface OpenAICompatibleConfig {
+    type: 'openai-compatible';
+    apiKey: string;
+    baseUrl: string;
+}
+export type ProviderConfig = OpenAIConfig | AnthropicConfig | GoogleConfig | OpenAICompatibleConfig;
+export interface AISettings {
+    openaiApiKey: string | null;
+    anthropicApiKey: string | null;
+    googleApiKey: string | null;
+    openaiCompatibleApiKey: string | null;
+    openaiCompatibleBaseUrl: string | null;
+    openaiCompatibleName: string | null;
+    openaiCompatibleModels: OpenAICompatibleModel[] | null;
+    openaiCompatibleHeaders: OpenAICompatibleHeader[] | null;
+    openaiAllowedModels: string[] | null;
+    anthropicAllowedModels: string[] | null;
+    googleAllowedModels: string[] | null;
+    systemPrompt: string | null;
+}
+export {};

package/dist/ai/providers/types.js

@@ -0,0 +1 @@
+export {};

package/dist/ai/tools/assets/index.js

@@ -1,6 +1,6 @@
-import { UnsupportedMediaTypeError } from '@directus/errors';
 import { dirname, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
+import { UnsupportedMediaTypeError } from '@directus/errors';
 import { z } from 'zod';
 import { AssetsService } from '../../../services/assets.js';
 import { FilesService } from '../../../services/files.js';

package/dist/ai/tools/collections/index.js

@@ -1,7 +1,7 @@
-import { InvalidPayloadError } from '@directus/errors';
-import { isObject, toArray } from '@directus/utils';
 import { dirname, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
+import { InvalidPayloadError } from '@directus/errors';
+import { isObject, toArray } from '@directus/utils';
 import { z } from 'zod';
 import { CollectionsService } from '../../../services/collections.js';
 import { requireText } from '../../../utils/require-text.js';

package/dist/ai/tools/fields/index.js

@@ -1,7 +1,7 @@
-import { InvalidPayloadError } from '@directus/errors';
-import { toArray } from '@directus/utils';
 import { dirname, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
+import { InvalidPayloadError } from '@directus/errors';
+import { toArray } from '@directus/utils';
 import { z } from 'zod';
 import { clearSystemCache } from '../../../cache.js';
 import getDatabase from '../../../database/index.js';

package/dist/ai/tools/files/index.js

@@ -1,6 +1,6 @@
-import { isObject } from '@directus/utils';
 import { dirname, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
+import { isObject } from '@directus/utils';
 import { z } from 'zod';
 import { FilesService } from '../../../services/files.js';
 import { requireText } from '../../../utils/require-text.js';

package/dist/ai/tools/flows/index.js

@@ -1,6 +1,6 @@
-import { isObject } from '@directus/utils';
 import { dirname, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
+import { isObject } from '@directus/utils';
 import { z } from 'zod';
 import { FlowsService } from '../../../services/flows.js';
 import { requireText } from '../../../utils/require-text.js';

package/dist/ai/tools/folders/index.js

@@ -1,6 +1,6 @@
-import { toArray } from '@directus/utils';
 import { dirname, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
+import { toArray } from '@directus/utils';
 import { z } from 'zod';
 import { FoldersService } from '../../../services/folders.js';
 import { requireText } from '../../../utils/require-text.js';

package/dist/ai/tools/items/index.js

@@ -1,9 +1,9 @@
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
 import { ForbiddenError, InvalidPayloadError } from '@directus/errors';
 import { isSystemCollection } from '@directus/system-data';
 import { toArray } from '@directus/utils';
 import { isObject } from 'graphql-compose';
-import { dirname, resolve } from 'node:path';
-import { fileURLToPath } from 'node:url';
 import { z } from 'zod';
 import { ItemsService } from '../../../services/items.js';
 import { requireText } from '../../../utils/require-text.js';
@@ -41,7 +41,10 @@ const ItemsInputSchema = z.object({
     collection: z.string().describe('The name of the collection'),
     query: QueryInputSchema.optional(),
     keys: z.array(PrimaryKeyInputSchema).optional(),
-    data: z.array(ItemInputSchema).optional().describe('Always an array of objects'),
+    data: z
+        .union([z.array(ItemInputSchema), ItemInputSchema])
+        .optional()
+        .describe('Object when using keys, array with PKs for batch updates'),
 });
 export const items = defineTool({
     name: 'items',

package/dist/ai/tools/items/prompt.md

@@ -99,7 +99,7 @@ Core: `_eq`, `_neq`, `_in`, `_nin`, `_null`, `_nnull`, `_lt`, `_lte`, `_gt`, `_g
 	"action": "update",
 	"collection": "posts",
 	"keys": ["uuid-1", "uuid-2"],
-	"data": [{ "status": "published" }] // Partial update
+	"data": { "status": "published" }
 }
 ```
 
@@ -123,15 +123,13 @@ Core: `_eq`, `_neq`, `_in`, `_nin`, `_null`, `_nnull`, `_lt`, `_lte`, `_gt`, `_g
 	"action": "update",
 	"collection": "posts",
 	"keys": ["uuid-1"],
-	"data": [
-		{
-			"categories": {
-				"create": [{ "name": "New Category" }],
-				"update": [{ "id": 3, "name": "Renamed" }],
-				"delete": [5]
-			}
+	"data": {
+		"categories": {
+			"create": [{ "name": "New Category" }],
+			"update": [{ "id": 3, "name": "Renamed" }],
+			"delete": [5]
 		}
-	]
+	}
 }
 ```
 

package/dist/ai/tools/relations/index.js

@@ -1,6 +1,6 @@
-import { InvalidPayloadError } from '@directus/errors';
 import { dirname, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
+import { InvalidPayloadError } from '@directus/errors';
 import { z } from 'zod';
 import { RelationsService } from '../../../services/relations.js';
 import { requireText } from '../../../utils/require-text.js';

package/dist/ai/tools/schema.js

@@ -108,7 +108,7 @@ export const FileImportItemValidateSchema = z.object({
     url: z.string(),
     file: FileItemValidateSchema,
 });
-// opertations
+// operations
 export const OperationItemInputSchema = z
     .object({
     id: z.string(),

package/dist/ai/tools/trigger-flow/index.js

@@ -1,6 +1,6 @@
-import { InvalidPayloadError } from '@directus/errors';
 import { dirname, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
+import { InvalidPayloadError } from '@directus/errors';
 import { z } from 'zod';
 import { getFlowManager } from '../../../flows.js';
 import { FlowsService } from '../../../services/flows.js';

package/dist/app.js

@@ -1,3 +1,6 @@
+import { readFile } from 'node:fs/promises';
+import { createRequire } from 'node:module';
+import path from 'path';
 import { useEnv } from '@directus/env';
 import { InvalidPayloadError, ServiceUnavailableError } from '@directus/errors';
 import { handlePressure } from '@directus/pressure';
@@ -5,10 +8,8 @@ import { toBoolean } from '@directus/utils';
 import cookieParser from 'cookie-parser';
 import express from 'express';
 import { merge } from 'lodash-es';
-import { readFile } from 'node:fs/promises';
-import { createRequire } from 'node:module';
-import path from 'path';
 import qs from 'qs';
+import { aiChatRouter } from './ai/chat/router.js';
 import { registerAuthProviders } from './auth.js';
 import accessRouter from './controllers/access.js';
 import activityRouter from './controllers/activity.js';
@@ -17,6 +18,7 @@ import authRouter from './controllers/auth.js';
 import collectionsRouter from './controllers/collections.js';
 import commentsRouter from './controllers/comments.js';
 import dashboardsRouter from './controllers/dashboards.js';
+import deploymentRouter from './controllers/deployment.js';
 import extensionsRouter from './controllers/extensions.js';
 import fieldsRouter from './controllers/fields.js';
 import filesRouter from './controllers/files.js';
@@ -45,8 +47,8 @@ import tusRouter from './controllers/tus.js';
 import usersRouter from './controllers/users.js';
 import utilsRouter from './controllers/utils.js';
 import versionsRouter from './controllers/versions.js';
-import webhooksRouter from './controllers/webhooks.js';
 import { isInstalled, validateDatabaseConnection, validateDatabaseExtensions, validateMigrations, } from './database/index.js';
+import { registerDeploymentDrivers } from './deployment.js';
 import emitter from './emitter.js';
 import { getExtensionManager } from './extensions/index.js';
 import { getFlowManager } from './flows.js';
@@ -61,14 +63,13 @@ import rateLimiter from './middleware/rate-limiter-ip.js';
 import sanitizeQuery from './middleware/sanitize-query.js';
 import schema from './middleware/schema.js';
 import metricsSchedule from './schedules/metrics.js';
+import projectSchedule from './schedules/project.js';
 import retentionSchedule from './schedules/retention.js';
 import telemetrySchedule from './schedules/telemetry.js';
 import tusSchedule from './schedules/tus.js';
-import projectSchedule from './schedules/project.js';
 import { getConfigFromEnv } from './utils/get-config-from-env.js';
 import { Url } from './utils/url.js';
 import { validateStorage } from './utils/validate-storage.js';
-import { aiChatRouter } from './ai/chat/router.js';
 const require = createRequire(import.meta.url);
 export default async function createApp() {
     const env = useEnv();
@@ -94,6 +95,7 @@ export default async function createApp() {
     await validateDatabaseExtensions();
     await validateStorage();
     await registerAuthProviders();
+    registerDeploymentDrivers();
     const extensionManager = getExtensionManager();
     const flowManager = getFlowManager();
     await extensionManager.initialize();
@@ -223,6 +225,7 @@ export default async function createApp() {
     app.use('/collections', collectionsRouter);
     app.use('/comments', commentsRouter);
     app.use('/dashboards', dashboardsRouter);
+    app.use('/deployments', deploymentRouter);
     app.use('/extensions', extensionsRouter);
     app.use('/fields', fieldsRouter);
     if (env['TUS_ENABLED'] === true) {
@@ -235,7 +238,9 @@ export default async function createApp() {
     if (toBoolean(env['MCP_ENABLED']) === true) {
         app.use('/mcp', mcpRouter);
     }
-    app.use('/ai/chat', aiChatRouter);
+    if (toBoolean(env['AI_ENABLED']) === true) {
+        app.use('/ai/chat', aiChatRouter);
+    }
     if (env['METRICS_ENABLED'] === true) {
         app.use('/metrics', metricsRouter);
     }
@@ -256,7 +261,6 @@ export default async function createApp() {
     app.use('/users', usersRouter);
     app.use('/utils', utilsRouter);
     app.use('/versions', versionsRouter);
-    app.use('/webhooks', webhooksRouter);
     // Register custom endpoints
     await emitter.emitInit('routes.custom.before', { app });
     app.use(extensionManager.getEndpointRouter());

package/dist/auth/drivers/ldap.d.ts

@@ -1,5 +1,5 @@
 import { Router } from 'express';
-import type { Client } from 'ldapjs';
+import { Client } from 'ldapts';
 import type { AuthDriverOptions, User } from '../../types/index.js';
 import { AuthDriver } from '../auth.js';
 export declare class LDAPAuthDriver extends AuthDriver {