feat: add @objectstack/rest package and update runtime to support optional REST API registration

Author: hotlong

packages/cli/package.json

@@ -27,6 +27,7 @@
     "@objectstack/driver-memory": "workspace:^",
     "@objectstack/objectql": "workspace:^",
     "@objectstack/plugin-hono-server": "workspace:*",
+    "@objectstack/rest": "workspace:*",
     "@objectstack/runtime": "workspace:^",
     "@objectstack/spec": "workspace:*",
     "bundle-require": "^5.1.0",

packages/cli/src/commands/serve.ts

@@ -226,6 +226,15 @@ export const serveCommand = new Command('serve')
         } catch (e: any) {
           console.warn(chalk.yellow(`  ⚠ HTTP server plugin not available: ${e.message}`));
         }
+
+        // Register REST API plugin (consumes http.server + protocol services)
+        try {
+          const { createRestApiPlugin } = await import('@objectstack/rest');
+          await kernel.use(createRestApiPlugin());
+          trackPlugin('RestAPI');
+        } catch (e: any) {
+          // @objectstack/rest is optional
+        }
       }
 
       // ── Studio UI (--ui) ────────────────────────────────────────────

packages/runtime/src/runtime.test.ts

@@ -24,11 +24,11 @@ describe('Runtime', () => {
         expect(runtime.getKernel()).toBeDefined();
     });
 
-    it('should register api registry plugin by default', () => {
+    it('should not auto-register any plugins', () => {
         const runtime = new Runtime();
         const kernel = runtime.getKernel();
-        // Check if use was called (at least once for api registry)
-        expect(kernel.use).toHaveBeenCalled();
+        // Runtime is a clean slate — no plugins auto-registered
+        expect(kernel.use).not.toHaveBeenCalled();
     });
 
     it('should register external http server if provided', () => {

packages/runtime/src/runtime.ts

@@ -1,5 +1,4 @@
 import { ObjectKernel, Plugin, IHttpServer, ObjectKernelConfig } from '@objectstack/core';
-import { createRestApiPlugin, RestApiPluginConfig } from '@objectstack/rest';
 
 export interface RuntimeConfig {
     /**
@@ -8,11 +7,6 @@ export interface RuntimeConfig {
      * If not provided, Runtime expects a server plugin (like HonoServerPlugin) to be registered manually.
      */
     server?: IHttpServer;
-    
-    /**
-     * API Registry Configuration
-     */
-    api?: RestApiPluginConfig;
 
     /**
      * Kernel Configuration
@@ -26,8 +20,13 @@ export interface RuntimeConfig {
  * High-level entry point for bootstrapping an ObjectStack application.
  * Wraps ObjectKernel and provides standard orchestration for:
  * - HTTP Server binding
- * - API Registry (REST Routes)
  * - Plugin Management
+ * 
+ * REST API is opt-in — register it explicitly:
+ * ```ts
+ * import { createRestApiPlugin } from '@objectstack/rest';
+ * runtime.use(createRestApiPlugin());
+ * ```
  */
 export class Runtime {
     readonly kernel: ObjectKernel;
@@ -37,17 +36,8 @@ export class Runtime {
 
         // If external server provided, register it immediately
         if (config.server) {
-             // If the provided server is not already an HttpServer wrapper, wrap it?
-             // Since IHttpServer is the interface, we assume it complies.
-             // But HttpServer class in runtime is an adapter.
-             // If user passes raw Hono, it won't work unless they wrapped it.
-             // We'll assume they pass a compliant IHttpServer.
              this.kernel.registerService('http.server', config.server);
         }
-        
-        // Register API Registry by default
-        // This plugin is passive (wait for services) so it's safe to add early.
-        this.kernel.use(createRestApiPlugin(config.api));
     }
 
     /**