@agentxjs/core 2.0.0 → 3.0.0

package/src/event/types/session.ts

@@ -13,38 +13,35 @@ import type { SystemEvent } from "./base";
 /**
  * Base SessionLifecycleEvent
  */
-interface BaseSessionLifecycleEvent<T extends string, D = unknown> extends SystemEvent<
-  T,
-  D,
-  "session",
-  "lifecycle",
-  "notification"
-> {}
+interface BaseSessionLifecycleEvent<T extends string, D = unknown>
+  extends SystemEvent<T, D, "session", "lifecycle", "notification"> {}
 
 /**
  * SessionCreatedEvent - Session was created
  */
-export interface SessionCreatedEvent extends BaseSessionLifecycleEvent<
-  "session_created",
-  {
-    sessionId: string;
-    imageId: string;
-    containerId: string;
-    title?: string;
-    createdAt: number;
-  }
-> {}
+export interface SessionCreatedEvent
+  extends BaseSessionLifecycleEvent<
+    "session_created",
+    {
+      sessionId: string;
+      imageId: string;
+      containerId: string;
+      title?: string;
+      createdAt: number;
+    }
+  > {}
 
 /**
  * SessionDestroyedEvent - Session was destroyed
  */
-export interface SessionDestroyedEvent extends BaseSessionLifecycleEvent<
-  "session_destroyed",
-  {
-    sessionId: string;
-    reason?: string;
-  }
-> {}
+export interface SessionDestroyedEvent
+  extends BaseSessionLifecycleEvent<
+    "session_destroyed",
+    {
+      sessionId: string;
+      reason?: string;
+    }
+  > {}
 
 /**
  * SessionLifecycleEvent - All session lifecycle events
@@ -68,72 +65,66 @@ export function isSessionLifecycleEvent(event: {
 /**
  * Base SessionPersistRequest
  */
-interface BaseSessionPersistRequest<T extends string, D = unknown> extends SystemEvent<
-  T,
-  D,
-  "session",
-  "persist",
-  "request"
-> {}
+interface BaseSessionPersistRequest<T extends string, D = unknown>
+  extends SystemEvent<T, D, "session", "persist", "request"> {}
 
 /**
  * Base SessionPersistResult
  */
-interface BaseSessionPersistResult<T extends string, D = unknown> extends SystemEvent<
-  T,
-  D,
-  "session",
-  "persist",
-  "result"
-> {}
+interface BaseSessionPersistResult<T extends string, D = unknown>
+  extends SystemEvent<T, D, "session", "persist", "result"> {}
 
 /**
  * SessionSaveRequest - Request to save session
  */
-export interface SessionSaveRequest extends BaseSessionPersistRequest<
-  "session_save_request",
-  {
-    sessionId: string;
-    title?: string;
-    metadata?: Record<string, unknown>;
-  }
-> {}
+export interface SessionSaveRequest
+  extends BaseSessionPersistRequest<
+    "session_save_request",
+    {
+      sessionId: string;
+      title?: string;
+      metadata?: Record<string, unknown>;
+    }
+  > {}
 
 /**
  * SessionSavedEvent - Session was saved
  */
-export interface SessionSavedEvent extends BaseSessionPersistResult<
-  "session_saved",
-  {
-    sessionId: string;
-    savedAt: number;
-  }
-> {}
+export interface SessionSavedEvent
+  extends BaseSessionPersistResult<
+    "session_saved",
+    {
+      sessionId: string;
+      savedAt: number;
+    }
+  > {}
 
 /**
  * MessagePersistRequest - Request to persist a message
  */
-export interface MessagePersistRequest extends BaseSessionPersistRequest<
-  "message_persist_request",
-  {
-    sessionId: string;
-    messageId: string;
-    role: "user" | "assistant" | "tool_call" | "tool_result";
-    content: unknown;
-  }
-> {}
+export interface MessagePersistRequest
+  extends BaseSessionPersistRequest<
+    "message_persist_request",
+    {
+      sessionId: string;
+      messageId: string;
+      role: "user" | "assistant" | "tool_call" | "tool_result";
+      content: unknown;
+    }
+  > {}
 
 /**
  * MessagePersistedEvent - Message was persisted
  */
-export interface MessagePersistedEvent extends BaseSessionPersistResult<
-  "message_persisted",
-  {
-    sessionId: string;
-    messageId: string;
-    savedAt: number;
-  }
-> {}
+export interface MessagePersistedEvent
+  extends BaseSessionPersistResult<
+    "message_persisted",
+    {
+      sessionId: string;
+      messageId: string;
+      savedAt: number;
+    }
+  > {}
 
 /**
  * SessionPersistEvent - All session persist events
@@ -171,94 +162,90 @@ export function isSessionPersistEvent(event: {
 /**
  * Base SessionActionRequest
  */
-interface BaseSessionActionRequest<T extends string, D = unknown> extends SystemEvent<
-  T,
-  D,
-  "session",
-  "action",
-  "request"
-> {}
+interface BaseSessionActionRequest<T extends string, D = unknown>
+  extends SystemEvent<T, D, "session", "action", "request"> {}
 
 /**
  * Base SessionActionResult
  */
-interface BaseSessionActionResult<T extends string, D = unknown> extends SystemEvent<
-  T,
-  D,
-  "session",
-  "action",
-  "result"
-> {}
+interface BaseSessionActionResult<T extends string, D = unknown>
+  extends SystemEvent<T, D, "session", "action", "result"> {}
 
 /**
  * SessionResumeRequest - Request to resume a session
  */
-export interface SessionResumeRequest extends BaseSessionActionRequest<
-  "session_resume_request",
-  {
-    sessionId: string;
-    containerId?: string;
-  }
-> {}
+export interface SessionResumeRequest
+  extends BaseSessionActionRequest<
+    "session_resume_request",
+    {
+      sessionId: string;
+      containerId?: string;
+    }
+  > {}
 
 /**
  * SessionResumedEvent - Session was resumed
  */
-export interface SessionResumedEvent extends BaseSessionActionResult<
-  "session_resumed",
-  {
-    sessionId: string;
-    agentId: string;
-    resumedAt: number;
-  }
-> {}
+export interface SessionResumedEvent
+  extends BaseSessionActionResult<
+    "session_resumed",
+    {
+      sessionId: string;
+      agentId: string;
+      resumedAt: number;
+    }
+  > {}
 
 /**
  * SessionForkRequest - Request to fork a session
  */
-export interface SessionForkRequest extends BaseSessionActionRequest<
-  "session_fork_request",
-  {
-    sessionId: string;
-    newTitle?: string;
-  }
-> {}
+export interface SessionForkRequest
+  extends BaseSessionActionRequest<
+    "session_fork_request",
+    {
+      sessionId: string;
+      newTitle?: string;
+    }
+  > {}
 
 /**
  * SessionForkedEvent - Session was forked
  */
-export interface SessionForkedEvent extends BaseSessionActionResult<
-  "session_forked",
-  {
-    originalSessionId: string;
-    newSessionId: string;
-    newImageId: string;
-    forkedAt: number;
-  }
-> {}
+export interface SessionForkedEvent
+  extends BaseSessionActionResult<
+    "session_forked",
+    {
+      originalSessionId: string;
+      newSessionId: string;
+      newImageId: string;
+      forkedAt: number;
+    }
+  > {}
 
 /**
  * SessionTitleUpdateRequest - Request to update session title
  */
-export interface SessionTitleUpdateRequest extends BaseSessionActionRequest<
-  "session_title_update_request",
-  {
-    sessionId: string;
-    title: string;
-  }
-> {}
+export interface SessionTitleUpdateRequest
+  extends BaseSessionActionRequest<
+    "session_title_update_request",
+    {
+      sessionId: string;
+      title: string;
+    }
+  > {}
 
 /**
  * SessionTitleUpdatedEvent - Session title was updated
  */
-export interface SessionTitleUpdatedEvent extends BaseSessionActionResult<
-  "session_title_updated",
-  {
-    sessionId: string;
-    title: string;
-    updatedAt: number;
-  }
-> {}
+export interface SessionTitleUpdatedEvent
+  extends BaseSessionActionResult<
+    "session_title_updated",
+    {
+      sessionId: string;
+      title: string;
+      updatedAt: number;
+    }
+  > {}
 
 /**
  * SessionActionEvent - All session action events

package/src/image/Image.ts

@@ -6,7 +6,7 @@
  */
 
 import { createLogger } from "commonxjs/logger";
-import type { Image, ImageRecord, ImageContext, ImageCreateConfig } from "./types";
+import type { Image, ImageContext, ImageCreateConfig, ImageRecord } from "./types";
 
 const logger = createLogger("image/Image");
 

package/src/image/index.ts

@@ -24,13 +24,12 @@
  * ```
  */
 
+export { createImage, ImageImpl, loadImage } from "./Image";
 export type {
-  ImageMetadata,
-  ImageRecord,
-  ImageRepository,
   Image,
   ImageContext,
   ImageCreateConfig,
+  ImageMetadata,
+  ImageRecord,
+  ImageRepository,
 } from "./types";
-
-export { ImageImpl, createImage, loadImage } from "./Image";

package/src/mq/OffsetGenerator.ts

@@ -43,6 +43,6 @@ export class OffsetGenerator {
     const timeDiff = parseInt(aTime, 36) - parseInt(bTime, 36);
     if (timeDiff !== 0) return timeDiff;
 
-    return parseInt(aSeq) - parseInt(bSeq);
+    return parseInt(aSeq, 10) - parseInt(bSeq, 10);
   }
 }

package/src/mq/__tests__/OffsetGenerator.test.ts

@@ -2,7 +2,7 @@
  * OffsetGenerator.test.ts - Unit tests for OffsetGenerator
  */
 
-import { describe, it, expect, beforeEach } from "bun:test";
+import { beforeEach, describe, expect, it } from "bun:test";
 import { OffsetGenerator } from "../OffsetGenerator";
 
 describe("OffsetGenerator", () => {

package/src/mq/index.ts

@@ -7,12 +7,11 @@
  * - OffsetGenerator: Utility for generating monotonic offsets
  */
 
+export { OffsetGenerator } from "./OffsetGenerator";
 export type {
-  QueueEntry,
-  QueueConfig,
-  Unsubscribe,
   MessageQueue,
   MessageQueueProvider,
+  QueueConfig,
+  QueueEntry,
+  Unsubscribe,
 } from "./types";
-
-export { OffsetGenerator } from "./OffsetGenerator";

package/src/network/RpcClient.ts

@@ -25,31 +25,31 @@
  * ```
  */
 
+import type { SystemEvent } from "../event/types/base";
 import {
-  createRequest,
   createNotification,
-  parseMessage,
-  isSuccessResponse,
+  createRequest,
   isErrorResponse,
   isNotification,
   isStreamEvent,
-  type RpcMethod,
+  isSuccessResponse,
   type NotificationMethod,
+  parseMessage,
+  type RpcMethod,
   type StreamEventParams,
 } from "./jsonrpc";
-import type { SystemEvent } from "../event/types/base";
 
 // ============================================================================
 // Types
 // ============================================================================
 
 /**
- * Factory function for creating WebSocket instances.
- * Platform layer provides the implementation:
- * - Browser: native WebSocket (default)
+ * Factory for creating client-side WebSocket connections.
+ * Injected via Platform:
+ * - Browser: native WebSocket (default fallback)
  * - Node.js: ws library (via @agentxjs/node-platform)
  */
-export type WebSocketFactory = (url: string) => WebSocket;
+export type ChannelClientFactory = (url: string) => WebSocket;
 
 /**
  * RpcClient configuration
@@ -64,7 +64,7 @@ export interface RpcClientConfig {
    * Factory for creating WebSocket instances.
    * If not provided, falls back to the global WebSocket constructor.
    */
-  createWebSocket?: WebSocketFactory;
+  createWebSocket?: ChannelClientFactory;
 
   /**
    * Request timeout in milliseconds (default: 30000)

package/src/network/index.ts

@@ -12,65 +12,62 @@
  * - @agentxjs/cloudflare: Durable Objects WebSocket
  */
 
-// Types
-export type {
-  Unsubscribe,
-  MinimalHTTPServer,
-  SendReliableOptions,
-  ConnectionState,
-  ChannelConnection,
-  ChannelServer,
-  ChannelServerOptions,
-  ChannelClient,
-  ChannelClientOptions,
-  ChannelServerProvider,
-  ChannelClientProvider,
-} from "./types";
-
-// Protocol (reliable delivery)
-export type { ReliableWrapper, AckMessage } from "./protocol";
-export {
-  isReliableWrapper,
-  isAckMessage,
-  wrapMessage,
-  createAck,
-  unwrapMessage,
-  generateMessageId,
-} from "./protocol";
-
 // JSON-RPC 2.0 Protocol
 export type {
-  RpcMethod,
+  ControlAckParams,
   NotificationMethod,
-  RpcRequest,
-  RpcSuccessResponse,
   RpcErrorResponse,
+  RpcMethod,
   RpcNotification,
+  RpcRequest,
+  RpcSuccessResponse,
   StreamEventParams,
-  ControlAckParams,
 } from "./jsonrpc";
 export {
-  JsonRpcError,
-  RpcErrorCodes,
-  createRequest,
+  createAckNotification,
+  createErrorResponse,
   createNotification,
+  createRequest,
   createStreamEvent,
-  createAckNotification,
   createSuccessResponse,
-  createErrorResponse,
-  parseMessage,
-  parseMessageObject,
-  isRequest,
-  isNotification,
-  isSuccessResponse,
+  eventTypeToRpcMethod,
+  isControlAck,
   isErrorResponse,
   isInvalid,
+  isNotification,
+  isRequest,
   isStreamEvent,
-  isControlAck,
-  eventTypeToRpcMethod,
+  isSuccessResponse,
+  JsonRpcError,
+  parseMessage,
+  parseMessageObject,
+  RpcErrorCodes,
   rpcMethodToResponseType,
 } from "./jsonrpc";
-
+// Protocol (reliable delivery)
+export type { AckMessage, ReliableWrapper } from "./protocol";
+export {
+  createAck,
+  generateMessageId,
+  isAckMessage,
+  isReliableWrapper,
+  unwrapMessage,
+  wrapMessage,
+} from "./protocol";
 // RPC Client
-export type { RpcClientConfig, RpcClientState, WebSocketFactory } from "./RpcClient";
+export type { ChannelClientFactory, RpcClientConfig, RpcClientState } from "./RpcClient";
 export { RpcClient } from "./RpcClient";
+// Types
+export type {
+  ChannelClient,
+  ChannelClientOptions,
+  ChannelClientProvider,
+  ChannelConnection,
+  ChannelServer,
+  ChannelServerOptions,
+  ChannelServerProvider,
+  ConnectionState,
+  MinimalHTTPServer,
+  SendReliableOptions,
+  Unsubscribe,
+} from "./types";

package/src/network/jsonrpc.ts

@@ -11,16 +11,16 @@
  * @see https://www.jsonrpc.org/specification
  */
 
+import type { IParsedObject, JsonRpc } from "jsonrpc-lite";
 import {
-  request as jsonrpcRequest,
-  notification as jsonrpcNotification,
-  success as jsonrpcSuccess,
+  JsonRpcError,
   error as jsonrpcError,
+  notification as jsonrpcNotification,
   parse as jsonrpcParse,
   parseObject as jsonrpcParseObject,
-  JsonRpcError,
+  request as jsonrpcRequest,
+  success as jsonrpcSuccess,
 } from "jsonrpc-lite";
-import type { IParsedObject, JsonRpc } from "jsonrpc-lite";
 import type { SystemEvent } from "../event/types/base";
 
 // ============================================================================

package/src/persistence/index.ts

@@ -12,16 +12,16 @@
  */
 
 export type {
-  // Config types
-  McpServerConfig,
   ContainerConfig,
-  ImageMetadata,
   // Record types
   ContainerRecord,
-  ImageRecord,
-  SessionRecord,
   // Repository interfaces
   ContainerRepository,
+  ImageMetadata,
+  ImageRecord,
   ImageRepository,
+  // Config types
+  McpServerConfig,
+  SessionRecord,
   SessionRepository,
 } from "./types";

package/src/platform/types.ts

@@ -19,12 +19,13 @@
  * ```
  */
 
+import type { BashProvider } from "../bash/types";
 import type { ContainerRepository } from "../container/types";
+import type { EventBus } from "../event/types";
 import type { ImageRepository } from "../image/types";
+import type { ChannelClientFactory } from "../network/RpcClient";
+import type { ChannelServer } from "../network/types";
 import type { SessionRepository } from "../session/types";
-import type { EventBus } from "../event/types";
-import type { BashProvider } from "../bash/types";
-import type { WebSocketFactory } from "../network/RpcClient";
 
 // ============================================================================
 // AgentXPlatform - Dependency Injection
@@ -75,10 +76,19 @@ export interface AgentXPlatform {
   readonly bashProvider?: BashProvider;
 
   /**
-   * WebSocket factory for creating client connections
+   * Channel server for accepting client connections (server-side)
+   *
+   * Optional — only needed for server scenarios.
+   * Node.js platform provides ws-based implementation.
+   * Cloudflare platform provides DO Hibernation API implementation.
+   */
+  readonly channelServer?: ChannelServer;
+
+  /**
+   * Channel client factory for creating connections (client-side)
    *
    * Optional — browser uses native WebSocket by default.
    * Node.js platform provides ws-based implementation.
    */
-  readonly webSocketFactory?: WebSocketFactory;
+  readonly channelClient?: ChannelClientFactory;
 }

package/src/runtime/AgentXRuntime.ts

@@ -12,26 +12,18 @@
  */
 
 import { createLogger } from "commonxjs/logger";
+import { createAgent as createAgentEngine } from "../agent/createAgent";
 import type {
-  AgentXPlatform,
-  AgentXRuntime,
-  RuntimeAgent,
-  CreateAgentOptions,
-  AgentEventHandler,
-  Subscription,
-  AgentLifecycle,
-} from "./types";
-import type {
-  UserContentPart,
-  UserMessage,
   AgentEngine,
-  StreamEvent,
   AgentOutput,
   AgentPresenter,
   AgentSource,
   Message,
+  StreamEvent,
+  UserContentPart,
+  UserMessage,
 } from "../agent/types";
-import type { BusEvent } from "../event/types";
+import { createBashTool } from "../bash/tool";
 import type {
   CreateDriver,
   Driver,
@@ -39,9 +31,17 @@ import type {
   DriverStreamEvent,
   ToolDefinition,
 } from "../driver/types";
+import type { BusEvent } from "../event/types";
 import { createSession } from "../session/Session";
-import { createBashTool } from "../bash/tool";
-import { createAgent as createAgentEngine } from "../agent/createAgent";
+import type {
+  AgentEventHandler,
+  AgentLifecycle,
+  AgentXPlatform,
+  AgentXRuntime,
+  CreateAgentOptions,
+  RuntimeAgent,
+  Subscription,
+} from "./types";
 
 const logger = createLogger("runtime/AgentXRuntime");