Update API route schemas and router mounts

Standardized API route names and example paths in ApiRoutesSchema, renaming 'actions' to 'automation' and updating descriptions and examples. Added a 'mounts' object to RouterConfigSchema to define default protocol mount points, aligning with the updated route schema.

Author: hotlong

packages/spec/src/api/discovery.zod.ts

@@ -17,23 +17,23 @@ export const ApiCapabilitiesSchema = z.object({
  * This decouples the frontend from hardcoded URL paths.
  */
 export const ApiRoutesSchema = z.object({
-  /** Base URL for Object CRUD (Standard Data API) */
-  data: z.string().describe('e.g. /api/v1/data'),
+  /** Base URL for Object CRUD (Data Protocol) */
+  data: z.string().describe('e.g. /api/data'),
 
-  /** Base URL for Schema Definitions (Metadata API) */
-  metadata: z.string().describe('e.g. /api/v1/meta'),
+  /** Base URL for Schema Definitions (Metadata Protocol) */
+  metadata: z.string().describe('e.g. /api/meta'),
 
   /** Base URL for Authentication */
-  auth: z.string().describe('e.g. /api/v1/auth'),
+  auth: z.string().describe('e.g. /api/auth'),
 
-  /** Base URL for Server Actions/Flows */
-  actions: z.string().optional().describe('e.g. /api/v1/p'),
+  /** Base URL for Automation (Flows/Scripts) */
+  automation: z.string().optional().describe('e.g. /api/automation'),
 
   /** Base URL for File/Storage operations */
-  storage: z.string().optional().describe('e.g. /api/v1/storage'),
+  storage: z.string().optional().describe('e.g. /api/storage'),
 
   /** GraphQL Endpoint (if enabled) */
-  graphql: z.string().optional().describe('e.g. /api/v1/graphql'),
+  graphql: z.string().optional().describe('e.g. /graphql'),
 });
 
 /**

packages/spec/src/api/router.zod.ts

@@ -87,6 +87,18 @@ export const RouterConfigSchema = z.object({
    */
   basePath: z.string().default('/api').describe('Global API prefix'),
 
+  /**
+   * Standard Protocol Mounts (Relative to basePath)
+   */
+  mounts: z.object({
+    data: z.string().default('/data').describe('Data Protocol (CRUD)'),
+    metadata: z.string().default('/meta').describe('Metadata Protocol (Schemas)'),
+    auth: z.string().default('/auth').describe('Auth Protocol'),
+    automation: z.string().default('/automation').describe('Automation Protocol'),
+    storage: z.string().default('/storage').describe('Storage Protocol'),
+    graphql: z.string().default('/graphql').describe('GraphQL Endpoint'),
+  }).default({}), // Defaults match standardized spec
+
   /**
    * Cross-Origin Resource Sharing
    */