@revealui/ai 0.1.0

package/dist/tools/cms/collection-tools.d.ts

@@ -0,0 +1,36 @@
+/**
+ * CMS Collection Tools
+ * Tools for managing collection documents (create, read, update, delete)
+ */
+import type { Tool } from '../base.js';
+/**
+ * Tool: List all collections
+ * Returns available collections in the CMS
+ */
+export declare const listCollectionsTool: Tool;
+/**
+ * Tool: Find documents in a collection
+ * Search and retrieve documents from a specific collection
+ */
+export declare const findDocumentsTool: Tool;
+/**
+ * Tool: Get a single document by ID
+ * Retrieve a specific document from a collection
+ */
+export declare const getDocumentTool: Tool;
+/**
+ * Tool: Create a new document
+ * Add a new document to a collection
+ */
+export declare const createDocumentTool: Tool;
+/**
+ * Tool: Update an existing document
+ * Modify a document in a collection
+ */
+export declare const updateDocumentTool: Tool;
+/**
+ * Tool: Delete a document
+ * Remove a document from a collection
+ */
+export declare const deleteDocumentTool: Tool;
+//# sourceMappingURL=collection-tools.d.ts.map

package/dist/tools/cms/collection-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collection-tools.d.ts","sourceRoot":"","sources":["../../../src/tools/cms/collection-tools.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAc,MAAM,YAAY,CAAA;AAElD;;;GAGG;AACH,eAAO,MAAM,mBAAmB,EAAE,IAiCjC,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,iBAAiB,EAAE,IA2C/B,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,IAwB7B,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,IA+BhC,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,IAmChC,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,IAwBhC,CAAA"}

package/dist/tools/cms/collection-tools.js

@@ -0,0 +1,178 @@
+/**
+ * CMS Collection Tools
+ * Tools for managing collection documents (create, read, update, delete)
+ */
+import { z } from 'zod/v4';
+/**
+ * Tool: List all collections
+ * Returns available collections in the CMS
+ */
+export const listCollectionsTool = {
+    name: 'list_collections',
+    description: 'Get a list of all available CMS collections. Use this to discover what content types exist (e.g., pages, posts, users, media).',
+    parameters: z.object({}),
+    async execute() {
+        try {
+            // This will be injected with RevealUI config at runtime
+            // For now, return common collections
+            const collections = [
+                { slug: 'pages', label: 'Pages', description: 'Website pages' },
+                { slug: 'posts', label: 'Posts', description: 'Blog posts' },
+                { slug: 'media', label: 'Media', description: 'Images and files' },
+                { slug: 'users', label: 'Users', description: 'User accounts' },
+                { slug: 'categories', label: 'Categories', description: 'Content categories' },
+                { slug: 'tags', label: 'Tags', description: 'Content tags' },
+            ];
+            return {
+                success: true,
+                data: {
+                    collections,
+                    count: collections.length,
+                },
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: `Failed to list collections: ${error instanceof Error ? error.message : String(error)}`,
+            };
+        }
+    },
+};
+/**
+ * Tool: Find documents in a collection
+ * Search and retrieve documents from a specific collection
+ */
+export const findDocumentsTool = {
+    name: 'find_documents',
+    description: 'Search for documents in a CMS collection. Use this to find existing content before creating or updating.',
+    parameters: z.object({
+        collection: z.string().describe('The collection slug (e.g., "pages", "posts", "users")'),
+        page: z.number().optional().describe('Page number for pagination (default: 1)'),
+        limit: z.number().optional().describe('Number of results per page (default: 10)'),
+        where: z
+            .record(z.string(), z.unknown())
+            .optional()
+            .describe('Filter conditions (e.g., {status: "published"})'),
+        sort: z.string().optional().describe('Sort field (e.g., "-createdAt" for newest first)'),
+    }),
+    async execute(params) {
+        const { collection: _collection, page: _page = 1, limit: _limit = 10, where: _where, sort: _sort, } = params;
+        try {
+            // Note: This requires the apiClient to be available at runtime
+            // The actual implementation will be injected when registering the tool
+            throw new Error('API client not configured. This tool must be registered with an API client instance.');
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: `Failed to find documents: ${error instanceof Error ? error.message : String(error)}`,
+            };
+        }
+    },
+};
+/**
+ * Tool: Get a single document by ID
+ * Retrieve a specific document from a collection
+ */
+export const getDocumentTool = {
+    name: 'get_document',
+    description: 'Get a specific document by ID from a CMS collection. Use this to retrieve full details of a single item.',
+    parameters: z.object({
+        collection: z.string().describe('The collection slug (e.g., "pages", "posts")'),
+        id: z.string().describe('The document ID'),
+    }),
+    async execute(params) {
+        const { collection: _collection, id: _id } = params;
+        try {
+            // API client will be injected at runtime
+            throw new Error('API client not configured. This tool must be registered with an API client instance.');
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: `Failed to get document: ${error instanceof Error ? error.message : String(error)}`,
+            };
+        }
+    },
+};
+/**
+ * Tool: Create a new document
+ * Add a new document to a collection
+ */
+export const createDocumentTool = {
+    name: 'create_document',
+    description: 'Create a new document in a CMS collection. Use this to add new content like pages, posts, or other records.',
+    parameters: z.object({
+        collection: z.string().describe('The collection slug (e.g., "pages", "posts")'),
+        data: z
+            .record(z.string(), z.unknown())
+            .describe('The document data as key-value pairs (e.g., {title: "My Page", slug: "my-page", content: "..."})'),
+    }),
+    async execute(params) {
+        const { collection: _collection, data: _data } = params;
+        try {
+            // API client will be injected at runtime
+            throw new Error('API client not configured. This tool must be registered with an API client instance.');
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: `Failed to create document: ${error instanceof Error ? error.message : String(error)}`,
+            };
+        }
+    },
+};
+/**
+ * Tool: Update an existing document
+ * Modify a document in a collection
+ */
+export const updateDocumentTool = {
+    name: 'update_document',
+    description: 'Update an existing document in a CMS collection. Use this to modify content like changing titles, updating text, etc.',
+    parameters: z.object({
+        collection: z.string().describe('The collection slug (e.g., "pages", "posts")'),
+        id: z.string().describe('The document ID to update'),
+        data: z
+            .record(z.string(), z.unknown())
+            .describe('The fields to update as key-value pairs (e.g., {title: "Updated Title"})'),
+    }),
+    async execute(params) {
+        const { collection: _collection, id: _id, data: _data, } = params;
+        try {
+            // API client will be injected at runtime
+            throw new Error('API client not configured. This tool must be registered with an API client instance.');
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: `Failed to update document: ${error instanceof Error ? error.message : String(error)}`,
+            };
+        }
+    },
+};
+/**
+ * Tool: Delete a document
+ * Remove a document from a collection
+ */
+export const deleteDocumentTool = {
+    name: 'delete_document',
+    description: 'Delete a document from a CMS collection. Use this to remove unwanted content. This action is permanent.',
+    parameters: z.object({
+        collection: z.string().describe('The collection slug (e.g., "pages", "posts")'),
+        id: z.string().describe('The document ID to delete'),
+    }),
+    async execute(params) {
+        const { collection: _collection, id: _id } = params;
+        try {
+            // API client will be injected at runtime
+            throw new Error('API client not configured. This tool must be registered with an API client instance.');
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: `Failed to delete document: ${error instanceof Error ? error.message : String(error)}`,
+            };
+        }
+    },
+};

package/dist/tools/cms/factory.d.ts

@@ -0,0 +1,89 @@
+/**
+ * CMS Tools Factory
+ * Creates CMS tools with API client injected for actual execution
+ */
+import type { Tool } from '../base.js';
+/**
+ * API Client interface (compatible with @revealui/core/admin/utils/apiClient)
+ */
+export interface CMSAPIClient {
+    find(options: {
+        collection: string;
+        page?: number;
+        limit?: number;
+        where?: Record<string, unknown>;
+        sort?: string;
+    }): Promise<{
+        docs?: unknown[];
+        totalDocs?: number;
+        page?: number;
+        totalPages?: number;
+    }>;
+    findById(collection: string, id: string): Promise<unknown>;
+    create(options: {
+        collection: string;
+        data: Record<string, unknown>;
+    }): Promise<unknown>;
+    update(options: {
+        collection: string;
+        id: string;
+        data: Record<string, unknown>;
+    }): Promise<unknown>;
+    delete(options: {
+        collection: string;
+        id: string;
+    }): Promise<void>;
+    findGlobal(options: {
+        slug: string;
+        depth?: number;
+    }): Promise<unknown>;
+    updateGlobal(options: {
+        slug: string;
+        data: Record<string, unknown>;
+    }): Promise<unknown>;
+}
+/**
+ * Collection metadata for CMS tools
+ * Simplified representation of a collection configuration
+ */
+export interface CollectionMetadata {
+    slug: string;
+    label?: string;
+    description?: string;
+}
+/**
+ * Global metadata for CMS tools
+ * Simplified representation of a global configuration
+ */
+export interface GlobalMetadata {
+    slug: string;
+    label?: string;
+    description?: string;
+}
+/**
+ * User context for CMS tools
+ */
+export interface UserContext {
+    id: string;
+    email: string;
+    role?: string;
+}
+/**
+ * Configuration interface for CMS tools
+ */
+export interface CMSToolsConfig {
+    /** API client instance */
+    apiClient: CMSAPIClient;
+    /** Available collections (optional, for list_collections tool) */
+    collections?: CollectionMetadata[];
+    /** Available globals (optional, for list_globals tool) */
+    globals?: GlobalMetadata[];
+    /** Current user context (for permission checks) */
+    user?: UserContext;
+}
+/**
+ * Create CMS tools with API client injected
+ * This factory function creates functional tools by injecting the actual API implementation
+ */
+export declare function createCMSTools(config: CMSToolsConfig): Tool[];
+//# sourceMappingURL=factory.d.ts.map

package/dist/tools/cms/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../src/tools/cms/factory.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAA;AAyBtC;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,OAAO,EAAE;QACZ,UAAU,EAAE,MAAM,CAAA;QAClB,IAAI,CAAC,EAAE,MAAM,CAAA;QACb,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;QAC/B,IAAI,CAAC,EAAE,MAAM,CAAA;KACd,GAAG,OAAO,CAAC;QACV,IAAI,CAAC,EAAE,OAAO,EAAE,CAAA;QAChB,SAAS,CAAC,EAAE,MAAM,CAAA;QAClB,IAAI,CAAC,EAAE,MAAM,CAAA;QACb,UAAU,CAAC,EAAE,MAAM,CAAA;KACpB,CAAC,CAAA;IAEF,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAE1D,MAAM,CAAC,OAAO,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAExF,MAAM,CAAC,OAAO,EAAE;QACd,UAAU,EAAE,MAAM,CAAA;QAClB,EAAE,EAAE,MAAM,CAAA;QACV,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAC9B,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAEpB,MAAM,CAAC,OAAO,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAElE,UAAU,CAAC,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAEvE,YAAY,CAAC,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;CACzF;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,0BAA0B;IAC1B,SAAS,EAAE,YAAY,CAAA;IAEvB,kEAAkE;IAClE,WAAW,CAAC,EAAE,kBAAkB,EAAE,CAAA;IAElC,0DAA0D;IAC1D,OAAO,CAAC,EAAE,cAAc,EAAE,CAAA;IAE1B,mDAAmD;IACnD,IAAI,CAAC,EAAE,WAAW,CAAA;CACnB;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,EAAE,CAggB7D"}