refactor(server): make platform-agnostic

.changeset/server-platform-agnostic.md

@@ -0,0 +1,5 @@
+---
+"@agentxjs/server": patch
+---
+
+Make @agentxjs/server platform-agnostic by removing @agentxjs/node-platform dependency. ServerConfig.platform now accepts AgentXPlatform directly. Replace commonxjs/logger with @deepracticex/logger.

apps/cli/src/index.ts

@@ -73,11 +73,12 @@ async function getServerUrl(port: number): Promise<{ url: string; cleanup?: () =
     });
   };
 
+  const platform = await nodePlatform({
+    dataPath,
+    // logDir already configured at startup
+  }).resolve();
   const server = await createServer({
-    platform: nodePlatform({
-      dataPath,
-      // logDir already configured at startup
-    }),
+    platform,
     createDriver: wrappedCreateDriver,
     port,
     host: "127.0.0.1",

apps/portagent/lib/agentx/index.ts

@@ -101,8 +101,9 @@ export async function startAgentXServer(): Promise<void> {
         hasApiKey: !!initialConfig.apiKey,
       });
 
+      const platform = await nodePlatform({ dataPath }).resolve();
       const config: ServerConfig = {
-        platform: nodePlatform({ dataPath }),
+        platform,
         createDriver: (driverConfig: DriverConfig) => {
           // Read latest config from DB on each agent creation
           const llm = getLLMConfigFromDB();

packages/server/bin/server.ts

@@ -18,7 +18,7 @@
 import type { CreateDriver } from "@agentxjs/core/driver";
 import { createMonoDriver } from "@agentxjs/mono-driver";
 import { nodePlatform } from "@agentxjs/node-platform";
-import { createLogger } from "commonxjs/logger";
+import { createLogger } from "@deepracticex/logger";
 import { createServer } from "../src";
 
 const logger = createLogger("server/bin");
@@ -61,11 +61,9 @@ async function main() {
   };
 
   // Create server with nodePlatform + driver
+  const platform = await nodePlatform({ dataPath, logDir }).resolve();
   const server = await createServer({
-    platform: nodePlatform({
-      dataPath,
-      logDir,
-    }),
+    platform,
     createDriver: wrappedCreateDriver,
     port,
     host,

packages/server/package.json

@@ -28,11 +28,11 @@
   },
   "dependencies": {
     "@agentxjs/core": "workspace:*",
-    "@agentxjs/node-platform": "workspace:*",
-    "@agentxjs/mono-driver": "workspace:*",
-    "commonxjs": "^0.1.1"
+    "@deepracticex/logger": "^1.2.0"
   },
   "devDependencies": {
+    "@agentxjs/node-platform": "workspace:*",
+    "@agentxjs/mono-driver": "workspace:*",
     "typescript": "^5.3.3"
   }
 }

packages/server/src/CommandHandler.ts

@@ -10,7 +10,7 @@
 import type { UserContentPart } from "@agentxjs/core/agent";
 import type { RpcMethod } from "@agentxjs/core/network";
 import type { AgentXRuntime } from "@agentxjs/core/runtime";
-import { createLogger } from "commonxjs/logger";
+import { createLogger } from "@deepracticex/logger";
 
 const logger = createLogger("server/CommandHandler");
 

packages/server/src/Server.ts

@@ -26,8 +26,7 @@ import {
 } from "@agentxjs/core/network";
 import type { AgentXPlatform } from "@agentxjs/core/runtime";
 import { createAgentXRuntime } from "@agentxjs/core/runtime";
-import { type DeferredPlatformConfig, isDeferredPlatform } from "@agentxjs/node-platform";
-import { createLogger } from "commonxjs/logger";
+import { createLogger } from "@deepracticex/logger";
 import { CommandHandler } from "./CommandHandler";
 import type { AgentXServer } from "./types";
 
@@ -46,11 +45,9 @@ interface ConnectionState {
  */
 export interface ServerConfig {
   /**
-   * AgentX Platform (can be AgentXPlatform or DeferredPlatformConfig)
-   *
-   * Must provide `channelServer` for accepting WebSocket connections.
+   * AgentX Platform — must provide `channelServer` for accepting WebSocket connections.
    */
-  platform: AgentXPlatform | DeferredPlatformConfig;
+  platform: AgentXPlatform;
 
   /**
    * LLM Driver factory function - creates Driver per Agent
@@ -88,11 +85,7 @@ export interface ServerConfig {
  */
 export async function createServer(config: ServerConfig): Promise<AgentXServer> {
   const { wsPath = "/ws" } = config;
-
-  // Resolve deferred platform if needed
-  const platform: AgentXPlatform = isDeferredPlatform(config.platform)
-    ? await config.platform.resolve()
-    : config.platform;
+  const platform = config.platform;
 
   // Create runtime from platform + driver
   const runtime = createAgentXRuntime(platform, config.createDriver);