@revealui/ai 0.2.7 → 0.2.9

package/dist/skills/registry/skill-registry.js

@@ -132,7 +132,7 @@ export class SkillRegistry {
                 }
             }
             catch {
-                // Skip directories with missing or invalid skill.json — registry remains partial
+                // Skip directories with missing or invalid skill.json  -  registry remains partial
             }
         }
     }

package/dist/skills/types.d.ts

@@ -27,13 +27,13 @@ export declare const SkillMetadataSchema: z.ZodObject<{
     repository: z.ZodOptional<z.ZodString>;
     tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
     compatibility: z.ZodOptional<z.ZodArray<z.ZodEnum<{
-        openai: "openai";
-        anthropic: "anthropic";
         "claude-code": "claude-code";
         cursor: "cursor";
         windsurf: "windsurf";
         cline: "cline";
         copilot: "copilot";
+        openai: "openai";
+        anthropic: "anthropic";
         universal: "universal";
     }>>>;
     allowedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -78,13 +78,13 @@ export declare const SkillSchema: z.ZodObject<{
         repository: z.ZodOptional<z.ZodString>;
         tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
         compatibility: z.ZodOptional<z.ZodArray<z.ZodEnum<{
-            openai: "openai";
-            anthropic: "anthropic";
             "claude-code": "claude-code";
             cursor: "cursor";
             windsurf: "windsurf";
             cline: "cline";
             copilot: "copilot";
+            openai: "openai";
+            anthropic: "anthropic";
             universal: "universal";
         }>>>;
         allowedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -143,13 +143,13 @@ export declare const SkillActivationResultSchema: z.ZodObject<{
             repository: z.ZodOptional<z.ZodString>;
             tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
             compatibility: z.ZodOptional<z.ZodArray<z.ZodEnum<{
-                openai: "openai";
-                anthropic: "anthropic";
                 "claude-code": "claude-code";
                 cursor: "cursor";
                 windsurf: "windsurf";
                 cline: "cline";
                 copilot: "copilot";
+                openai: "openai";
+                anthropic: "anthropic";
                 universal: "universal";
             }>>>;
             allowedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;

package/dist/templates/prompt-spec.js

@@ -83,7 +83,7 @@ export const PromptSpecSchema = z.object({
     guardrails: PromptGuardrailsSchema,
     /** Security constraints */
     security: PromptSecuritySchema,
-    /** Examples — at least one required for documentation and testing */
+    /** Examples  -  at least one required for documentation and testing */
     examples: z.array(PromptExampleSchema).min(1, 'At least one example is required'),
     /** Who created this prompt */
     author: z.string().min(1),

package/dist/templates/skill-spec.js

@@ -66,7 +66,7 @@ export const SkillSpecSchema = z.object({
     permissions: SkillPermissionsSchema,
     /** Security constraints */
     security: SkillSecuritySchema,
-    /** Test cases — at least one required */
+    /** Test cases  -  at least one required */
     testCases: z.array(SkillTestCaseSchema).min(1, 'At least one test case is required'),
     /** Who created this skill */
     author: z.string().min(1),

package/dist/tools/{cms → admin}/collection-tools.d.ts

@@ -1,11 +1,11 @@
 /**
- * CMS Collection Tools
+ * Admin 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
+ * Returns available collections in the admin
  */
 export declare const listCollectionsTool: Tool;
 /**

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

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

package/dist/tools/{cms → admin}/collection-tools.js

@@ -1,15 +1,15 @@
 /**
- * CMS Collection Tools
+ * Admin 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
+ * Returns available collections in the admin
  */
 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).',
+    description: 'Get a list of all available admin collections. Use this to discover what content types exist (e.g., pages, posts, users, media).',
     parameters: z.object({}),
     async execute() {
         try {
@@ -45,7 +45,7 @@ export const listCollectionsTool = {
  */
 export const findDocumentsTool = {
     name: 'find_documents',
-    description: 'Search for documents in a CMS collection. Use this to find existing content before creating or updating.',
+    description: 'Search for documents in an admin 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)'),
@@ -77,7 +77,7 @@ export const findDocumentsTool = {
  */
 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.',
+    description: 'Get a specific document by ID from an admin 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'),
@@ -102,7 +102,7 @@ export const getDocumentTool = {
  */
 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.',
+    description: 'Create a new document in an admin 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
@@ -129,7 +129,7 @@ export const createDocumentTool = {
  */
 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.',
+    description: 'Update an existing document in an admin 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'),
@@ -157,7 +157,7 @@ export const updateDocumentTool = {
  */
 export const deleteDocumentTool = {
     name: 'delete_document',
-    description: 'Delete a document from a CMS collection. Use this to remove unwanted content. This action is permanent.',
+    description: 'Delete a document from an admin 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'),

package/dist/tools/{cms → admin}/factory.d.ts

@@ -1,12 +1,12 @@
 /**
- * CMS Tools Factory
- * Creates CMS tools with API client injected for actual execution
+ * admin Tools Factory
+ * Creates admin 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 {
+export interface AdminAPIClient {
     find(options: {
         collection: string;
         page?: number;
@@ -43,7 +43,7 @@ export interface CMSAPIClient {
     }): Promise<unknown>;
 }
 /**
- * Collection metadata for CMS tools
+ * Collection metadata for admin tools
  * Simplified representation of a collection configuration
  */
 export interface CollectionMetadata {
@@ -52,7 +52,7 @@ export interface CollectionMetadata {
     description?: string;
 }
 /**
- * Global metadata for CMS tools
+ * Global metadata for admin tools
  * Simplified representation of a global configuration
  */
 export interface GlobalMetadata {
@@ -61,7 +61,7 @@ export interface GlobalMetadata {
     description?: string;
 }
 /**
- * User context for CMS tools
+ * User context for admin tools
  */
 export interface UserContext {
     id: string;
@@ -69,11 +69,11 @@ export interface UserContext {
     role?: string;
 }
 /**
- * Configuration interface for CMS tools
+ * Configuration interface for admin tools
  */
-export interface CMSToolsConfig {
+export interface AdminToolsConfig {
     /** API client instance */
-    apiClient: CMSAPIClient;
+    apiClient: AdminAPIClient;
     /** Available collections (optional, for list_collections tool) */
     collections?: CollectionMetadata[];
     /** Available globals (optional, for list_globals tool) */
@@ -82,8 +82,8 @@ export interface CMSToolsConfig {
     user?: UserContext;
 }
 /**
- * Create CMS tools with API client injected
+ * Create admin tools with API client injected
  * This factory function creates functional tools by injecting the actual API implementation
  */
-export declare function createCMSTools(config: CMSToolsConfig): Tool[];
+export declare function createAdminTools(config: AdminToolsConfig): Tool[];
 //# sourceMappingURL=factory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../src/tools/admin/factory.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAyBvC;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,OAAO,EAAE;QACZ,UAAU,EAAE,MAAM,CAAC;QACnB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAChC,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,GAAG,OAAO,CAAC;QACV,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC;QACjB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC,CAAC;IAEH,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAE3D,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,CAAC;IAEzF,MAAM,CAAC,OAAO,EAAE;QACd,UAAU,EAAE,MAAM,CAAC;QACnB,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAC/B,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAErB,MAAM,CAAC,OAAO,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnE,UAAU,CAAC,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAExE,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,CAAC;CAC1F;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,0BAA0B;IAC1B,SAAS,EAAE,cAAc,CAAC;IAE1B,kEAAkE;IAClE,WAAW,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAEnC,0DAA0D;IAC1D,OAAO,CAAC,EAAE,cAAc,EAAE,CAAC;IAE3B,mDAAmD;IACnD,IAAI,CAAC,EAAE,WAAW,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,EAAE,CAggBjE"}

package/dist/tools/{cms → admin}/factory.js

@@ -1,16 +1,16 @@
 /**
- * CMS Tools Factory
- * Creates CMS tools with API client injected for actual execution
+ * admin Tools Factory
+ * Creates admin tools with API client injected for actual execution
  */
 import { createDocumentTool, deleteDocumentTool, findDocumentsTool, getDocumentTool, listCollectionsTool, updateDocumentTool, } from './collection-tools.js';
 import { getGlobalTool, listGlobalsTool, updateGlobalTool } from './global-tools.js';
 import { deleteMediaTool, getMediaTool, listMediaTool, updateMediaTool, uploadMediaTool, } from './media-tools.js';
 import { createUserTool, deleteUserTool, getCurrentUserTool, listUsersTool, updateUserTool, } from './user-tools.js';
 /**
- * Create CMS tools with API client injected
+ * Create admin tools with API client injected
  * This factory function creates functional tools by injecting the actual API implementation
  */
-export function createCMSTools(config) {
+export function createAdminTools(config) {
     const { apiClient, collections, globals, user } = config;
     // Clone tools and inject API client implementation
     const tools = [];

package/dist/tools/{cms → admin}/global-tools.d.ts

@@ -1,5 +1,5 @@
 /**
- * CMS Global Tools
+ * Admin Global Tools
  * Tools for managing global content (Header, Footer, Settings)
  */
 import type { Tool } from '../base.js';

package/dist/tools/admin/global-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"global-tools.d.ts","sourceRoot":"","sources":["../../../src/tools/admin/global-tools.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAc,MAAM,YAAY,CAAC;AAEnD;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,IA6B7B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,aAAa,EAAE,IAwB3B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,IA+B9B,CAAC"}

package/dist/tools/{cms → admin}/global-tools.js

@@ -1,5 +1,5 @@
 /**
- * CMS Global Tools
+ * Admin Global Tools
  * Tools for managing global content (Header, Footer, Settings)
  */
 import { z } from 'zod/v4';
@@ -9,7 +9,7 @@ import { z } from 'zod/v4';
  */
 export const listGlobalsTool = {
     name: 'list_globals',
-    description: 'Get a list of all available CMS globals. Globals are site-wide settings like Header, Footer, and Settings.',
+    description: 'Get a list of all available admin globals. Globals are site-wide settings like Header, Footer, and Settings.',
     parameters: z.object({}),
     async execute() {
         try {
@@ -41,7 +41,7 @@ export const listGlobalsTool = {
  */
 export const getGlobalTool = {
     name: 'get_global',
-    description: 'Get the current configuration of a CMS global. Use this to see the current state before updating (e.g., current header navigation items).',
+    description: 'Get the current configuration of a admin global. Use this to see the current state before updating (e.g., current header navigation items).',
     parameters: z.object({
         slug: z.string().describe('The global slug (e.g., "header", "footer", "settings")'),
         depth: z.number().optional().describe('Depth of populated relationships (default: 0, max: 10)'),
@@ -66,7 +66,7 @@ export const getGlobalTool = {
  */
 export const updateGlobalTool = {
     name: 'update_global',
-    description: 'Update a CMS global configuration. Use this to modify site-wide settings like header navigation, footer links, or global settings. Common uses:\n- Add/remove navigation links in header\n- Update footer content\n- Change site-wide settings\n\nExample for header navigation:\n{\n  "slug": "header",\n  "data": {\n    "navItems": [\n      {"link": {"type": "custom", "label": "Home", "url": "/"}},\n      {"link": {"type": "custom", "label": "About", "url": "/about"}}\n    ]\n  }\n}',
+    description: 'Update a admin global configuration. Use this to modify site-wide settings like header navigation, footer links, or global settings. Common uses:\n- Add/remove navigation links in header\n- Update footer content\n- Change site-wide settings\n\nExample for header navigation:\n{\n  "slug": "header",\n  "data": {\n    "navItems": [\n      {"link": {"type": "custom", "label": "Home", "url": "/"}},\n      {"link": {"type": "custom", "label": "About", "url": "/about"}}\n    ]\n  }\n}',
     parameters: z.object({
         slug: z.string().describe('The global slug (e.g., "header", "footer", "settings")'),
         data: z

package/dist/tools/{cms → admin}/index.d.ts

@@ -1,10 +1,10 @@
 /**
- * CMS Tools Package
- * Complete set of tools for AI-powered CMS management
+ * admin Tools Package
+ * Complete set of tools for AI-powered admin management
  */
 export { createDocumentTool, deleteDocumentTool, findDocumentsTool, getDocumentTool, listCollectionsTool, updateDocumentTool, } from './collection-tools.js';
-export type { CMSAPIClient, CMSToolsConfig, CollectionMetadata, GlobalMetadata, UserContext, } from './factory.js';
-export { createCMSTools } from './factory.js';
+export type { AdminAPIClient, AdminToolsConfig, CollectionMetadata, GlobalMetadata, UserContext, } from './factory.js';
+export { createAdminTools } from './factory.js';
 export { getGlobalTool, listGlobalsTool, updateGlobalTool } from './global-tools.js';
 export { deleteMediaTool, getMediaTool, listMediaTool, updateMediaTool, uploadMediaTool, } from './media-tools.js';
 export { createUserTool, deleteUserTool, getCurrentUserTool, listUsersTool, updateUserTool, } from './user-tools.js';

package/dist/tools/admin/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/admin/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EACf,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EACV,cAAc,EACd,gBAAgB,EAChB,kBAAkB,EAClB,cAAc,EACd,WAAW,GACZ,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEhD,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAErF,OAAO,EACL,eAAe,EACf,YAAY,EACZ,aAAa,EACb,eAAe,EACf,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,cAAc,EACd,cAAc,EACd,kBAAkB,EAClB,aAAa,EACb,cAAc,GACf,MAAM,iBAAiB,CAAC"}

package/dist/tools/{cms → admin}/index.js

@@ -1,11 +1,11 @@
 /**
- * CMS Tools Package
- * Complete set of tools for AI-powered CMS management
+ * admin Tools Package
+ * Complete set of tools for AI-powered admin management
  */
 // Export individual tool definitions (for documentation/reference)
 export { createDocumentTool, deleteDocumentTool, findDocumentsTool, getDocumentTool, listCollectionsTool, updateDocumentTool, } from './collection-tools.js';
 // Export factory for creating functional tools
-export { createCMSTools } from './factory.js';
+export { createAdminTools } from './factory.js';
 export { getGlobalTool, listGlobalsTool, updateGlobalTool } from './global-tools.js';
 export { deleteMediaTool, getMediaTool, listMediaTool, updateMediaTool, uploadMediaTool, } from './media-tools.js';
 export { createUserTool, deleteUserTool, getCurrentUserTool, listUsersTool, updateUserTool, } from './user-tools.js';

package/dist/tools/{cms → admin}/media-tools.d.ts

@@ -1,5 +1,5 @@
 /**
- * CMS Media Tools
+ * Admin Media Tools
  * Tools for managing media files (images, videos, documents)
  */
 import type { Tool } from '../base.js';

package/dist/tools/admin/media-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-tools.d.ts","sourceRoot":"","sources":["../../../src/tools/admin/media-tools.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAc,MAAM,YAAY,CAAC;AAEnD;;;GAGG;AACH,eAAO,MAAM,aAAa,EAAE,IAqC3B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,YAAY,EAAE,IAsB1B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,IAyC7B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,IAuB7B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,IAoC7B,CAAC"}

package/dist/tools/{cms → admin}/media-tools.js

@@ -1,5 +1,5 @@
 /**
- * CMS Media Tools
+ * Admin Media Tools
  * Tools for managing media files (images, videos, documents)
  */
 import { z } from 'zod/v4';
@@ -9,7 +9,7 @@ import { z } from 'zod/v4';
  */
 export const listMediaTool = {
     name: 'list_media',
-    description: 'Get a list of media files from the CMS media library. Use this to browse uploaded images, videos, and documents.',
+    description: 'Get a list of media files from the admin media library. Use this to browse uploaded images, videos, and documents.',
     parameters: z.object({
         page: z.number().optional().describe('Page number for pagination (default: 1)'),
         limit: z.number().optional().describe('Number of results per page (default: 10)'),
@@ -63,7 +63,7 @@ export const getMediaTool = {
  */
 export const uploadMediaTool = {
     name: 'upload_media',
-    description: 'Upload a new media file (image, video, or document) to the CMS. The file should be provided as a base64-encoded string.',
+    description: 'Upload a new media file (image, video, or document) to the admin. The file should be provided as a base64-encoded string.',
     parameters: z.object({
         filename: z.string().describe('The filename (e.g., "logo.png")'),
         mimeType: z.string().describe('The MIME type (e.g., "image/png", "image/jpeg")'),
@@ -93,7 +93,7 @@ export const uploadMediaTool = {
  */
 export const deleteMediaTool = {
     name: 'delete_media',
-    description: 'Delete a media file from the CMS media library. This removes both the database record and the file from storage. This action is permanent.',
+    description: 'Delete a media file from the admin media library. This removes both the database record and the file from storage. This action is permanent.',
     parameters: z.object({
         id: z.string().describe('The media file ID to delete'),
     }),

package/dist/tools/{cms → admin}/user-tools.d.ts

@@ -1,5 +1,5 @@
 /**
- * CMS User Tools
+ * Admin User Tools
  * Tools for user management and authentication
  */
 import type { Tool } from '../base.js';

package/dist/tools/admin/user-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-tools.d.ts","sourceRoot":"","sources":["../../../src/tools/admin/user-tools.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAc,MAAM,YAAY,CAAC;AAEnD;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,IAoBhC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,aAAa,EAAE,IAiC3B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,IAsC5B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,IAsC5B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,IAuB5B,CAAC"}

package/dist/tools/{cms → admin}/user-tools.js

@@ -1,5 +1,5 @@
 /**
- * CMS User Tools
+ * Admin User Tools
  * Tools for user management and authentication
  */
 import { z } from 'zod/v4';

package/dist/tools/coding/file-edit.d.ts

@@ -1,5 +1,5 @@
 /**
- * file_edit — Surgical string replacement in a file
+ * file_edit  -  Surgical string replacement in a file
  */
 import type { Tool } from '../base.js';
 export declare const fileEditTool: Tool;

package/dist/tools/coding/file-edit.js

@@ -1,5 +1,5 @@
 /**
- * file_edit — Surgical string replacement in a file
+ * file_edit  -  Surgical string replacement in a file
  */
 import { readFileSync, writeFileSync } from 'node:fs';
 import { z } from 'zod/v4';
@@ -23,7 +23,7 @@ export const fileEditTool = {
             return { success: false, error: check.reason };
         }
         if (old_text === new_text) {
-            return { success: false, error: 'old_text and new_text are identical — nothing to change' };
+            return { success: false, error: 'old_text and new_text are identical  -  nothing to change' };
         }
         const resolvedPath = resolveSafePath(path, config);
         try {

package/dist/tools/coding/file-glob.d.ts

@@ -1,5 +1,5 @@
 /**
- * file_glob — Fast file pattern matching with picomatch-style globs
+ * file_glob  -  Fast file pattern matching with picomatch-style globs
  */
 import type { Tool } from '../base.js';
 export declare const fileGlobTool: Tool;

package/dist/tools/coding/file-glob.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"file-glob.d.ts","sourceRoot":"","sources":["../../../src/tools/coding/file-glob.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EAAE,IAAI,EAAc,MAAM,YAAY,CAAC;AA+DnD,eAAO,MAAM,YAAY,EAAE,IAgE1B,CAAC"}
+{"version":3,"file":"file-glob.d.ts","sourceRoot":"","sources":["../../../src/tools/coding/file-glob.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EAAE,IAAI,EAAc,MAAM,YAAY,CAAC;AAgEnD,eAAO,MAAM,YAAY,EAAE,IAgE1B,CAAC"}

package/dist/tools/coding/file-glob.js

@@ -1,5 +1,5 @@
 /**
- * file_glob — Fast file pattern matching with picomatch-style globs
+ * file_glob  -  Fast file pattern matching with picomatch-style globs
  */
 import { readdirSync, statSync } from 'node:fs';
 import { join, relative } from 'node:path';
@@ -8,6 +8,7 @@ import { getSafetyConfig } from './safety.js';
 /** Simple glob matcher supporting *, **, and ? */
 function matchGlob(pattern, filePath) {
     const regex = pattern
+        .replace(/\\/g, '\\\\')
         .replace(/\./g, '\\.')
         .replace(/\*\*/g, '⟨GLOBSTAR⟩')
         .replace(/\*/g, '[^/]*')

package/dist/tools/coding/file-grep.d.ts

@@ -1,5 +1,5 @@
 /**
- * file_grep — Regex content search across files
+ * file_grep  -  Regex content search across files
  */
 import type { Tool } from '../base.js';
 export declare const fileGrepTool: Tool;

package/dist/tools/coding/file-grep.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"file-grep.d.ts","sourceRoot":"","sources":["../../../src/tools/coding/file-grep.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EAAE,IAAI,EAAc,MAAM,YAAY,CAAC;AAiGnD,eAAO,MAAM,YAAY,EAAE,IA0H1B,CAAC"}
+{"version":3,"file":"file-grep.d.ts","sourceRoot":"","sources":["../../../src/tools/coding/file-grep.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EAAE,IAAI,EAAc,MAAM,YAAY,CAAC;AAkGnD,eAAO,MAAM,YAAY,EAAE,IA0H1B,CAAC"}

package/dist/tools/coding/file-grep.js

@@ -1,5 +1,5 @@
 /**
- * file_grep — Regex content search across files
+ * file_grep  -  Regex content search across files
  */
 import { readdirSync, readFileSync, statSync } from 'node:fs';
 import { join, relative } from 'node:path';
@@ -8,6 +8,7 @@ import { getSafetyConfig } from './safety.js';
 /** Simple glob test for file filtering */
 function matchesGlob(filePath, glob) {
     const regex = glob
+        .replace(/\\/g, '\\\\')
         .replace(/\./g, '\\.')
         .replace(/\*\*/g, '⟨GLOBSTAR⟩')
         .replace(/\*/g, '[^/]*')

package/dist/tools/coding/file-read.d.ts

@@ -1,5 +1,5 @@
 /**
- * file_read — Read file contents with line numbers
+ * file_read  -  Read file contents with line numbers
  */
 import type { Tool } from '../base.js';
 export declare const fileReadTool: Tool;

package/dist/tools/coding/file-read.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"file-read.d.ts","sourceRoot":"","sources":["../../../src/tools/coding/file-read.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,IAAI,EAAc,MAAM,YAAY,CAAC;AAGnD,eAAO,MAAM,YAAY,EAAE,IAkE1B,CAAC"}
+{"version":3,"file":"file-read.d.ts","sourceRoot":"","sources":["../../../src/tools/coding/file-read.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,IAAI,EAAc,MAAM,YAAY,CAAC;AAGnD,eAAO,MAAM,YAAY,EAAE,IAsE1B,CAAC"}

package/dist/tools/coding/file-read.js

@@ -1,7 +1,7 @@
 /**
- * file_read — Read file contents with line numbers
+ * file_read  -  Read file contents with line numbers
  */
-import { readFileSync, statSync } from 'node:fs';
+import { readFileSync } from 'node:fs';
 import { z } from 'zod/v4';
 import { getSafetyConfig, resolveSafePath, validatePath } from './safety.js';
 export const fileReadTool = {
@@ -24,14 +24,20 @@ export const fileReadTool = {
         const maxLines = limit ?? 2000;
         const startLine = (offset ?? 1) - 1; // Convert to 0-based
         try {
-            const stat = statSync(resolvedPath);
-            if (stat.isDirectory()) {
-                return {
-                    success: false,
-                    error: `${path} is a directory, not a file. Use file_glob to list directory contents.`,
-                };
+            // Read first, then check if directory (avoids TOCTOU race between stat and read)
+            let raw;
+            try {
+                raw = readFileSync(resolvedPath, 'utf8');
+            }
+            catch (readErr) {
+                if (readErr.code === 'EISDIR') {
+                    return {
+                        success: false,
+                        error: `${path} is a directory, not a file. Use file_glob to list directory contents.`,
+                    };
+                }
+                throw readErr;
             }
-            const raw = readFileSync(resolvedPath, 'utf8');
             const allLines = raw.split('\n');
             const totalLines = allLines.length;
             const sliced = allLines.slice(startLine, startLine + maxLines);

package/dist/tools/coding/file-write.d.ts

@@ -1,5 +1,5 @@
 /**
- * file_write — Write entire file contents
+ * file_write  -  Write entire file contents
  */
 import type { Tool } from '../base.js';
 export declare const fileWriteTool: Tool;

package/dist/tools/coding/file-write.js

@@ -1,5 +1,5 @@
 /**
- * file_write — Write entire file contents
+ * file_write  -  Write entire file contents
  */
 import { mkdirSync, writeFileSync } from 'node:fs';
 import { dirname } from 'node:path';

package/dist/tools/coding/git-ops.d.ts

@@ -1,5 +1,5 @@
 /**
- * git_ops — Git operations wrapper (status, diff, log, blame)
+ * git_ops  -  Git operations wrapper (status, diff, log, blame)
  */
 import type { Tool } from '../base.js';
 export declare const gitOpsTool: Tool;

package/dist/tools/coding/git-ops.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"git-ops.d.ts","sourceRoot":"","sources":["../../../src/tools/coding/git-ops.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,IAAI,EAAc,MAAM,YAAY,CAAC;AAyBnD,eAAO,MAAM,UAAU,EAAE,IA4FxB,CAAC"}
+{"version":3,"file":"git-ops.d.ts","sourceRoot":"","sources":["../../../src/tools/coding/git-ops.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,IAAI,EAAc,MAAM,YAAY,CAAC;AAuBnD,eAAO,MAAM,UAAU,EAAE,IA4FxB,CAAC"}

package/dist/tools/coding/git-ops.js

@@ -1,15 +1,14 @@
 /**
- * git_ops — Git operations wrapper (status, diff, log, blame)
+ * git_ops  -  Git operations wrapper (status, diff, log, blame)
  */
-import { execSync } from 'node:child_process';
+import { execFileSync } from 'node:child_process';
 import { z } from 'zod/v4';
 import { getSafetyConfig } from './safety.js';
 const GIT_OPERATIONS = ['status', 'diff', 'diff_full', 'log', 'blame', 'show', 'branch'];
 /** Max output per git command */
 const MAX_OUTPUT = 50_000;
 function runGit(args, cwd) {
-    const cmd = `git ${args.join(' ')}`;
-    return execSync(cmd, {
+    return execFileSync('git', args, {
         cwd,
         timeout: 15_000,
         maxBuffer: MAX_OUTPUT,
@@ -17,7 +16,6 @@ function runGit(args, cwd) {
         env: {
             ...process.env,
             GIT_TERMINAL_PROMPT: '0',
-            // Prevent pager from blocking
             GIT_PAGER: 'cat',
         },
     }).trim();
@@ -25,7 +23,7 @@ function runGit(args, cwd) {
 export const gitOpsTool = {
     name: 'git_ops',
     label: 'Git Operations',
-    description: 'Run read-only git operations: status, diff (summary), diff_full (full patch), log, blame, show, branch. Safe operations only — no push, commit, reset, or checkout.',
+    description: 'Run read-only git operations: status, diff (summary), diff_full (full patch), log, blame, show, branch. Safe operations only  -  no push, commit, reset, or checkout.',
     parameters: z.object({
         operation: z.enum(GIT_OPERATIONS).describe('Git operation to perform'),
         args: z
@@ -57,7 +55,7 @@ export const gitOpsTool = {
                     output = runGit(['diff', '--stat', ...args], config.projectRoot);
                     break;
                 case 'diff_full':
-                    // Full patch content for code review — hunks per file
+                    // Full patch content for code review  -  hunks per file
                     output = runGit(['diff', '--no-color', '-U3', ...args], config.projectRoot);
                     break;
                 case 'log':

package/dist/tools/coding/index.d.ts

@@ -20,7 +20,7 @@ export { testRunnerTool } from './test-runner.js';
  * Configuration for the coding tools factory
  */
 export interface CodingToolsConfig {
-    /** Project root directory — all file operations sandboxed here */
+    /** Project root directory  -  all file operations sandboxed here */
     projectRoot: string;
     /** Additional directories to allow (e.g., /tmp for scratch files) */
     allowedPaths?: string[];