@agentxjs/types 0.0.9 → 0.2.0

package/dist/index.js

@@ -1,151 +1,2 @@
-// src/common/logger/LogLevel.ts
-var LogLevel = /* @__PURE__ */ ((LogLevel2) => {
-  LogLevel2[LogLevel2["DEBUG"] = 0] = "DEBUG";
-  LogLevel2[LogLevel2["INFO"] = 1] = "INFO";
-  LogLevel2[LogLevel2["WARN"] = 2] = "WARN";
-  LogLevel2[LogLevel2["ERROR"] = 3] = "ERROR";
-  LogLevel2[LogLevel2["SILENT"] = 4] = "SILENT";
-  return LogLevel2;
-})(LogLevel || {});
-
-// src/llm/StopReason.ts
-function isStopReason(value) {
-  return [
-    "end_turn",
-    "max_tokens",
-    "tool_use",
-    "stop_sequence",
-    "content_filter",
-    "error",
-    "other"
-  ].includes(value);
-}
-
-// src/mcp/McpProtocol.ts
-var LATEST_PROTOCOL_VERSION = "2025-06-18";
-var SUPPORTED_PROTOCOL_VERSIONS = ["2025-06-18", "2025-03-26", "2024-11-05"];
-
-// src/guards/MessageGuards.ts
-function isUserMessage(message) {
-  return message.subtype === "user";
-}
-function isAssistantMessage(message) {
-  return message.subtype === "assistant";
-}
-function isSystemMessage(message) {
-  return message.subtype === "system";
-}
-function isToolCallMessage(message) {
-  return message.subtype === "tool-call";
-}
-function isToolResultMessage(message) {
-  return message.subtype === "tool-result";
-}
-
-// src/guards/ContentPartGuards.ts
-function isTextPart(part) {
-  return part.type === "text";
-}
-function isThinkingPart(part) {
-  return part.type === "thinking";
-}
-function isImagePart(part) {
-  return part.type === "image";
-}
-function isFilePart(part) {
-  return part.type === "file";
-}
-function isToolCallPart(part) {
-  return part.type === "tool-call";
-}
-function isToolResultPart(part) {
-  return part.type === "tool-result";
-}
-
-// src/guards/EventGuards.ts
-var STATE_EVENT_TYPE_NAMES = [
-  "agent_initializing",
-  "agent_ready",
-  "agent_destroyed",
-  "conversation_queued",
-  "conversation_start",
-  "conversation_thinking",
-  "conversation_responding",
-  "conversation_end",
-  "conversation_interrupted",
-  "tool_planned",
-  "tool_executing",
-  "tool_completed",
-  "tool_failed",
-  "error_occurred"
-];
-var STATE_EVENT_TYPES = new Set(STATE_EVENT_TYPE_NAMES);
-var MESSAGE_EVENT_TYPE_NAMES = [
-  "user_message",
-  "assistant_message",
-  "tool_call_message",
-  "tool_result_message"
-];
-var MESSAGE_EVENT_TYPES = new Set(MESSAGE_EVENT_TYPE_NAMES);
-var ERROR_EVENT_TYPE_NAMES = ["error"];
-var ERROR_EVENT_TYPES = new Set(ERROR_EVENT_TYPE_NAMES);
-var TURN_EVENT_TYPE_NAMES = ["turn_request", "turn_response"];
-var TURN_EVENT_TYPES = new Set(TURN_EVENT_TYPE_NAMES);
-var STREAM_EVENT_TYPE_NAMES = [
-  "message_start",
-  "message_delta",
-  "message_stop",
-  "text_content_block_start",
-  "text_delta",
-  "text_content_block_stop",
-  "tool_use_content_block_start",
-  "input_json_delta",
-  "tool_use_content_block_stop",
-  "tool_call",
-  "tool_result",
-  "interrupted"
-];
-var STREAM_EVENT_TYPES = new Set(STREAM_EVENT_TYPE_NAMES);
-function isStateEvent(event) {
-  return "type" in event && STATE_EVENT_TYPES.has(event.type);
-}
-function isMessageEvent(event) {
-  return "type" in event && MESSAGE_EVENT_TYPES.has(event.type);
-}
-function isTurnEvent(event) {
-  return "type" in event && TURN_EVENT_TYPES.has(event.type);
-}
-function isStreamEvent(event) {
-  return "type" in event && STREAM_EVENT_TYPES.has(event.type);
-}
-function isErrorEvent(event) {
-  return "type" in event && ERROR_EVENT_TYPES.has(event.type);
-}
-export {
-  ERROR_EVENT_TYPE_NAMES,
-  LATEST_PROTOCOL_VERSION,
-  LogLevel,
-  MESSAGE_EVENT_TYPE_NAMES,
-  STATE_EVENT_TYPE_NAMES,
-  STREAM_EVENT_TYPE_NAMES,
-  SUPPORTED_PROTOCOL_VERSIONS,
-  TURN_EVENT_TYPE_NAMES,
-  isAssistantMessage,
-  isErrorEvent,
-  isFilePart,
-  isImagePart,
-  isMessageEvent,
-  isStateEvent,
-  isStopReason,
-  isStreamEvent,
-  isSystemMessage,
-  isTextPart,
-  isThinkingPart,
-  isToolCallMessage,
-  isToolCallPart,
-  isToolResultMessage,
-  isToolResultPart,
-  isTurnEvent,
-  isUserMessage
-};
+import "./chunk-2QHAIM3V.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/common/logger/LogLevel.ts","../src/llm/StopReason.ts","../src/mcp/McpProtocol.ts","../src/guards/MessageGuards.ts","../src/guards/ContentPartGuards.ts","../src/guards/EventGuards.ts"],"sourcesContent":["/**\n * LogLevel - Standard log level enumeration\n *\n * Defines the severity levels for logging.\n */\n\nexport enum LogLevel {\n  DEBUG = 0,\n  INFO = 1,\n  WARN = 2,\n  ERROR = 3,\n  SILENT = 4,\n}\n","/**\n * Reason why the LLM stopped generating\n *\n * Based on common stop reasons across multiple LLM providers:\n * - Anthropic Claude: end_turn, max_tokens, tool_use, stop_sequence\n * - OpenAI: stop, length, tool_calls, content_filter\n * - Vercel AI SDK: stop, length, tool-calls, content-filter, error, other\n */\nexport type StopReason =\n  /**\n   * Natural completion - model decided to stop\n   */\n  | \"end_turn\"\n\n  /**\n   * Reached maximum token limit\n   */\n  | \"max_tokens\"\n\n  /**\n   * Model requested tool usage\n   */\n  | \"tool_use\"\n\n  /**\n   * Encountered a custom stop sequence\n   */\n  | \"stop_sequence\"\n\n  /**\n   * Content filter triggered\n   */\n  | \"content_filter\"\n\n  /**\n   * Error occurred during generation\n   */\n  | \"error\"\n\n  /**\n   * Other/unknown reason\n   */\n  | \"other\";\n\n/**\n * Type guard to check if a string is a valid StopReason\n */\nexport function isStopReason(value: string): value is StopReason {\n  return [\n    \"end_turn\",\n    \"max_tokens\",\n    \"tool_use\",\n    \"stop_sequence\",\n    \"content_filter\",\n    \"error\",\n    \"other\",\n  ].includes(value);\n}\n","/**\n * MCP Protocol Version\n *\n * Model Context Protocol version constants.\n * Based on the official MCP specification.\n */\nexport const LATEST_PROTOCOL_VERSION = \"2025-06-18\" as const;\n\nexport const SUPPORTED_PROTOCOL_VERSIONS = [\"2025-06-18\", \"2025-03-26\", \"2024-11-05\"] as const;\n\nexport type McpProtocolVersion = (typeof SUPPORTED_PROTOCOL_VERSIONS)[number];\n","import type { Message } from \"~/message/Message\";\nimport type { UserMessage } from \"~/message/UserMessage\";\nimport type { AssistantMessage } from \"~/message/AssistantMessage\";\nimport type { SystemMessage } from \"~/message/SystemMessage\";\nimport type { ToolCallMessage } from \"~/message/ToolCallMessage\";\nimport type { ToolResultMessage } from \"~/message/ToolResultMessage\";\n\n/**\n * Type guard for UserMessage\n */\nexport function isUserMessage(message: Message): message is UserMessage {\n  return message.subtype === \"user\";\n}\n\n/**\n * Type guard for AssistantMessage (text response, not tool call)\n */\nexport function isAssistantMessage(message: Message): message is AssistantMessage {\n  return message.subtype === \"assistant\";\n}\n\n/**\n * Type guard for SystemMessage\n */\nexport function isSystemMessage(message: Message): message is SystemMessage {\n  return message.subtype === \"system\";\n}\n\n/**\n * Type guard for ToolCallMessage\n */\nexport function isToolCallMessage(message: Message): message is ToolCallMessage {\n  return message.subtype === \"tool-call\";\n}\n\n/**\n * Type guard for ToolResultMessage\n */\nexport function isToolResultMessage(message: Message): message is ToolResultMessage {\n  return message.subtype === \"tool-result\";\n}\n","import type { ContentPart } from \"~/message/parts/ContentPart\";\nimport type { TextPart } from \"~/message/parts/TextPart\";\nimport type { ThinkingPart } from \"~/message/parts/ThinkingPart\";\nimport type { ImagePart } from \"~/message/parts/ImagePart\";\nimport type { FilePart } from \"~/message/parts/FilePart\";\nimport type { ToolCallPart } from \"~/message/parts/ToolCallPart\";\nimport type { ToolResultPart } from \"~/message/parts/ToolResultPart\";\n\n/**\n * Type guard for TextPart\n */\nexport function isTextPart(part: ContentPart): part is TextPart {\n  return part.type === \"text\";\n}\n\n/**\n * Type guard for ThinkingPart\n */\nexport function isThinkingPart(part: ContentPart): part is ThinkingPart {\n  return part.type === \"thinking\";\n}\n\n/**\n * Type guard for ImagePart\n */\nexport function isImagePart(part: ContentPart): part is ImagePart {\n  return part.type === \"image\";\n}\n\n/**\n * Type guard for FilePart\n */\nexport function isFilePart(part: ContentPart): part is FilePart {\n  return part.type === \"file\";\n}\n\n/**\n * Type guard for ToolCallPart\n */\nexport function isToolCallPart(part: ContentPart): part is ToolCallPart {\n  return part.type === \"tool-call\";\n}\n\n/**\n * Type guard for ToolResultPart\n */\nexport function isToolResultPart(part: ContentPart): part is ToolResultPart {\n  return part.type === \"tool-result\";\n}\n","/**\n * Event Type Guards\n *\n * Runtime type guards for event classification.\n */\n\nimport type { AgentOutput } from \"~/agent/AgentOutput\";\nimport type { StateEventType } from \"~/event/state\";\nimport type { StreamEventType } from \"~/event/stream\";\nimport type { MessageEventType } from \"~/event/message\";\nimport type { TurnEventType } from \"~/event/turn\";\nimport type { ErrorEvent } from \"~/event/error\";\n\n/**\n * State event type names (single source of truth)\n */\nexport const STATE_EVENT_TYPE_NAMES = [\n  \"agent_initializing\",\n  \"agent_ready\",\n  \"agent_destroyed\",\n  \"conversation_queued\",\n  \"conversation_start\",\n  \"conversation_thinking\",\n  \"conversation_responding\",\n  \"conversation_end\",\n  \"conversation_interrupted\",\n  \"tool_planned\",\n  \"tool_executing\",\n  \"tool_completed\",\n  \"tool_failed\",\n  \"error_occurred\",\n] as const;\n\nconst STATE_EVENT_TYPES = new Set<string>(STATE_EVENT_TYPE_NAMES);\n\n/**\n * Message event type names (single source of truth)\n */\nexport const MESSAGE_EVENT_TYPE_NAMES = [\n  \"user_message\",\n  \"assistant_message\",\n  \"tool_call_message\",\n  \"tool_result_message\",\n] as const;\n\nconst MESSAGE_EVENT_TYPES = new Set<string>(MESSAGE_EVENT_TYPE_NAMES);\n\n/**\n * Error event type names (single source of truth)\n * Error is independent from 4-layer hierarchy, transportable via SSE\n */\nexport const ERROR_EVENT_TYPE_NAMES = [\"error\"] as const;\n\nconst ERROR_EVENT_TYPES = new Set<string>(ERROR_EVENT_TYPE_NAMES);\n\n/**\n * Turn event type names (single source of truth)\n */\nexport const TURN_EVENT_TYPE_NAMES = [\"turn_request\", \"turn_response\"] as const;\n\nconst TURN_EVENT_TYPES = new Set<string>(TURN_EVENT_TYPE_NAMES);\n\n/**\n * Stream event type names (single source of truth)\n */\nexport const STREAM_EVENT_TYPE_NAMES = [\n  \"message_start\",\n  \"message_delta\",\n  \"message_stop\",\n  \"text_content_block_start\",\n  \"text_delta\",\n  \"text_content_block_stop\",\n  \"tool_use_content_block_start\",\n  \"input_json_delta\",\n  \"tool_use_content_block_stop\",\n  \"tool_call\",\n  \"tool_result\",\n  \"interrupted\",\n] as const;\n\nconst STREAM_EVENT_TYPES = new Set<string>(STREAM_EVENT_TYPE_NAMES);\n\n/**\n * Check if event is a StateEvent\n */\nexport function isStateEvent(event: AgentOutput): event is StateEventType {\n  return \"type\" in event && STATE_EVENT_TYPES.has(event.type);\n}\n\n/**\n * Check if event is a MessageEvent\n */\nexport function isMessageEvent(event: AgentOutput): event is MessageEventType {\n  return \"type\" in event && MESSAGE_EVENT_TYPES.has(event.type);\n}\n\n/**\n * Check if event is a TurnEvent\n */\nexport function isTurnEvent(event: AgentOutput): event is TurnEventType {\n  return \"type\" in event && TURN_EVENT_TYPES.has(event.type);\n}\n\n/**\n * Check if event is a StreamEvent\n */\nexport function isStreamEvent(event: AgentOutput): event is StreamEventType {\n  return \"type\" in event && STREAM_EVENT_TYPES.has(event.type);\n}\n\n/**\n * Check if event is an ErrorEvent\n */\nexport function isErrorEvent(event: AgentOutput): event is ErrorEvent {\n  return \"type\" in event && ERROR_EVENT_TYPES.has(event.type);\n}\n"],"mappings":";AAMO,IAAK,WAAL,kBAAKA,cAAL;AACL,EAAAA,oBAAA,WAAQ,KAAR;AACA,EAAAA,oBAAA,UAAO,KAAP;AACA,EAAAA,oBAAA,UAAO,KAAP;AACA,EAAAA,oBAAA,WAAQ,KAAR;AACA,EAAAA,oBAAA,YAAS,KAAT;AALU,SAAAA;AAAA,GAAA;;;ACyCL,SAAS,aAAa,OAAoC;AAC/D,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,EAAE,SAAS,KAAK;AAClB;;;ACnDO,IAAM,0BAA0B;AAEhC,IAAM,8BAA8B,CAAC,cAAc,cAAc,YAAY;;;ACE7E,SAAS,cAAc,SAA0C;AACtE,SAAO,QAAQ,YAAY;AAC7B;AAKO,SAAS,mBAAmB,SAA+C;AAChF,SAAO,QAAQ,YAAY;AAC7B;AAKO,SAAS,gBAAgB,SAA4C;AAC1E,SAAO,QAAQ,YAAY;AAC7B;AAKO,SAAS,kBAAkB,SAA8C;AAC9E,SAAO,QAAQ,YAAY;AAC7B;AAKO,SAAS,oBAAoB,SAAgD;AAClF,SAAO,QAAQ,YAAY;AAC7B;;;AC7BO,SAAS,WAAW,MAAqC;AAC9D,SAAO,KAAK,SAAS;AACvB;AAKO,SAAS,eAAe,MAAyC;AACtE,SAAO,KAAK,SAAS;AACvB;AAKO,SAAS,YAAY,MAAsC;AAChE,SAAO,KAAK,SAAS;AACvB;AAKO,SAAS,WAAW,MAAqC;AAC9D,SAAO,KAAK,SAAS;AACvB;AAKO,SAAS,eAAe,MAAyC;AACtE,SAAO,KAAK,SAAS;AACvB;AAKO,SAAS,iBAAiB,MAA2C;AAC1E,SAAO,KAAK,SAAS;AACvB;;;AChCO,IAAM,yBAAyB;AAAA,EACpC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAEA,IAAM,oBAAoB,IAAI,IAAY,sBAAsB;AAKzD,IAAM,2BAA2B;AAAA,EACtC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAEA,IAAM,sBAAsB,IAAI,IAAY,wBAAwB;AAM7D,IAAM,yBAAyB,CAAC,OAAO;AAE9C,IAAM,oBAAoB,IAAI,IAAY,sBAAsB;AAKzD,IAAM,wBAAwB,CAAC,gBAAgB,eAAe;AAErE,IAAM,mBAAmB,IAAI,IAAY,qBAAqB;AAKvD,IAAM,0BAA0B;AAAA,EACrC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAEA,IAAM,qBAAqB,IAAI,IAAY,uBAAuB;AAK3D,SAAS,aAAa,OAA6C;AACxE,SAAO,UAAU,SAAS,kBAAkB,IAAI,MAAM,IAAI;AAC5D;AAKO,SAAS,eAAe,OAA+C;AAC5E,SAAO,UAAU,SAAS,oBAAoB,IAAI,MAAM,IAAI;AAC9D;AAKO,SAAS,YAAY,OAA4C;AACtE,SAAO,UAAU,SAAS,iBAAiB,IAAI,MAAM,IAAI;AAC3D;AAKO,SAAS,cAAc,OAA8C;AAC1E,SAAO,UAAU,SAAS,mBAAmB,IAAI,MAAM,IAAI;AAC7D;AAKO,SAAS,aAAa,OAAyC;AACpE,SAAO,UAAU,SAAS,kBAAkB,IAAI,MAAM,IAAI;AAC5D;","names":["LogLevel"]}
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/network.cjs

@@ -0,0 +1,19 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/network/index.ts
+var network_exports = {};
+module.exports = __toCommonJS(network_exports);
+//# sourceMappingURL=network.cjs.map

package/dist/network.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/network/index.ts"],"sourcesContent":["/**\n * Network types\n */\n\nexport type {\n  Unsubscribe,\n  MinimalHTTPServer,\n  ChannelConnection,\n  ChannelServer,\n  ChannelClient,\n  ChannelClientOptions,\n  ChannelServerOptions,\n} from \"./Channel\";\n"],"mappings":";;;;;;;;;;;;;;;;AAAA;AAAA;","names":[]}

package/dist/network.d.cts

@@ -0,0 +1,168 @@
+/**
+ * Network Channel Abstraction
+ *
+ * Provides transport-agnostic interfaces for client-server communication.
+ * Can be implemented with WebSocket, HTTP/2, gRPC, etc.
+ */
+/**
+ * Minimal HTTP server interface for attaching WebSocket
+ * Avoids Node.js dependency in types package
+ */
+interface MinimalHTTPServer {
+    on(event: "upgrade", listener: (request: any, socket: any, head: any) => void): void;
+}
+/**
+ * Unsubscribe function type
+ */
+type Unsubscribe = () => void;
+/**
+ * Channel connection (server-side representation of a client)
+ */
+interface ChannelConnection {
+    /**
+     * Unique connection ID
+     */
+    readonly id: string;
+    /**
+     * Send message to this client
+     */
+    send(message: string): void;
+    /**
+     * Register message handler
+     */
+    onMessage(handler: (message: string) => void): Unsubscribe;
+    /**
+     * Register close handler
+     */
+    onClose(handler: () => void): Unsubscribe;
+    /**
+     * Register error handler
+     */
+    onError(handler: (error: Error) => void): Unsubscribe;
+    /**
+     * Close this connection
+     */
+    close(): void;
+}
+/**
+ * Channel server (accepts connections)
+ */
+interface ChannelServer {
+    /**
+     * Start listening on a port (standalone mode)
+     */
+    listen(port: number, host?: string): Promise<void>;
+    /**
+     * Attach to an existing HTTP server
+     */
+    attach(server: MinimalHTTPServer, path?: string): void;
+    /**
+     * Register connection handler
+     */
+    onConnection(handler: (connection: ChannelConnection) => void): Unsubscribe;
+    /**
+     * Broadcast message to all connected clients
+     */
+    broadcast(message: string): void;
+    /**
+     * Close server and all connections
+     */
+    close(): Promise<void>;
+    /**
+     * Dispose resources
+     */
+    dispose(): Promise<void>;
+}
+/**
+ * Channel client (connects to server)
+ */
+interface ChannelClient {
+    /**
+     * Connection state
+     */
+    readonly readyState: "connecting" | "open" | "closing" | "closed";
+    /**
+     * Connect to server
+     */
+    connect(): Promise<void>;
+    /**
+     * Send message to server
+     */
+    send(message: string): void;
+    /**
+     * Register message handler
+     */
+    onMessage(handler: (message: string) => void): Unsubscribe;
+    /**
+     * Register open handler
+     */
+    onOpen(handler: () => void): Unsubscribe;
+    /**
+     * Register close handler
+     */
+    onClose(handler: () => void): Unsubscribe;
+    /**
+     * Register error handler
+     */
+    onError(handler: (error: Error) => void): Unsubscribe;
+    /**
+     * Close connection
+     */
+    close(): void;
+    /**
+     * Dispose resources
+     */
+    dispose(): void;
+}
+/**
+ * Channel client factory options
+ */
+interface ChannelClientOptions {
+    /**
+     * Server URL
+     */
+    serverUrl: string;
+    /**
+     * Enable auto-reconnect (default: true in browser, false in Node.js)
+     */
+    autoReconnect?: boolean;
+    /**
+     * Min reconnection delay in ms (default: 1000)
+     */
+    minReconnectionDelay?: number;
+    /**
+     * Max reconnection delay in ms (default: 10000)
+     */
+    maxReconnectionDelay?: number;
+    /**
+     * Max retry attempts (default: Infinity)
+     */
+    maxRetries?: number;
+    /**
+     * Connection timeout in ms (default: 4000)
+     */
+    connectionTimeout?: number;
+    /**
+     * Enable debug logging (default: false)
+     */
+    debug?: boolean;
+}
+/**
+ * Channel server factory options
+ */
+interface ChannelServerOptions {
+    /**
+     * Enable heartbeat/ping-pong (default: true)
+     */
+    heartbeat?: boolean;
+    /**
+     * Heartbeat interval in ms (default: 30000)
+     */
+    heartbeatInterval?: number;
+    /**
+     * Enable debug logging (default: false)
+     */
+    debug?: boolean;
+}
+
+export type { ChannelClient, ChannelClientOptions, ChannelConnection, ChannelServer, ChannelServerOptions, MinimalHTTPServer, Unsubscribe };

package/dist/network.d.ts

@@ -0,0 +1,168 @@
+/**
+ * Network Channel Abstraction
+ *
+ * Provides transport-agnostic interfaces for client-server communication.
+ * Can be implemented with WebSocket, HTTP/2, gRPC, etc.
+ */
+/**
+ * Minimal HTTP server interface for attaching WebSocket
+ * Avoids Node.js dependency in types package
+ */
+interface MinimalHTTPServer {
+    on(event: "upgrade", listener: (request: any, socket: any, head: any) => void): void;
+}
+/**
+ * Unsubscribe function type
+ */
+type Unsubscribe = () => void;
+/**
+ * Channel connection (server-side representation of a client)
+ */
+interface ChannelConnection {
+    /**
+     * Unique connection ID
+     */
+    readonly id: string;
+    /**
+     * Send message to this client
+     */
+    send(message: string): void;
+    /**
+     * Register message handler
+     */
+    onMessage(handler: (message: string) => void): Unsubscribe;
+    /**
+     * Register close handler
+     */
+    onClose(handler: () => void): Unsubscribe;
+    /**
+     * Register error handler
+     */
+    onError(handler: (error: Error) => void): Unsubscribe;
+    /**
+     * Close this connection
+     */
+    close(): void;
+}
+/**
+ * Channel server (accepts connections)
+ */
+interface ChannelServer {
+    /**
+     * Start listening on a port (standalone mode)
+     */
+    listen(port: number, host?: string): Promise<void>;
+    /**
+     * Attach to an existing HTTP server
+     */
+    attach(server: MinimalHTTPServer, path?: string): void;
+    /**
+     * Register connection handler
+     */
+    onConnection(handler: (connection: ChannelConnection) => void): Unsubscribe;
+    /**
+     * Broadcast message to all connected clients
+     */
+    broadcast(message: string): void;
+    /**
+     * Close server and all connections
+     */
+    close(): Promise<void>;
+    /**
+     * Dispose resources
+     */
+    dispose(): Promise<void>;
+}
+/**
+ * Channel client (connects to server)
+ */
+interface ChannelClient {
+    /**
+     * Connection state
+     */
+    readonly readyState: "connecting" | "open" | "closing" | "closed";
+    /**
+     * Connect to server
+     */
+    connect(): Promise<void>;
+    /**
+     * Send message to server
+     */
+    send(message: string): void;
+    /**
+     * Register message handler
+     */
+    onMessage(handler: (message: string) => void): Unsubscribe;
+    /**
+     * Register open handler
+     */
+    onOpen(handler: () => void): Unsubscribe;
+    /**
+     * Register close handler
+     */
+    onClose(handler: () => void): Unsubscribe;
+    /**
+     * Register error handler
+     */
+    onError(handler: (error: Error) => void): Unsubscribe;
+    /**
+     * Close connection
+     */
+    close(): void;
+    /**
+     * Dispose resources
+     */
+    dispose(): void;
+}
+/**
+ * Channel client factory options
+ */
+interface ChannelClientOptions {
+    /**
+     * Server URL
+     */
+    serverUrl: string;
+    /**
+     * Enable auto-reconnect (default: true in browser, false in Node.js)
+     */
+    autoReconnect?: boolean;
+    /**
+     * Min reconnection delay in ms (default: 1000)
+     */
+    minReconnectionDelay?: number;
+    /**
+     * Max reconnection delay in ms (default: 10000)
+     */
+    maxReconnectionDelay?: number;
+    /**
+     * Max retry attempts (default: Infinity)
+     */
+    maxRetries?: number;
+    /**
+     * Connection timeout in ms (default: 4000)
+     */
+    connectionTimeout?: number;
+    /**
+     * Enable debug logging (default: false)
+     */
+    debug?: boolean;
+}
+/**
+ * Channel server factory options
+ */
+interface ChannelServerOptions {
+    /**
+     * Enable heartbeat/ping-pong (default: true)
+     */
+    heartbeat?: boolean;
+    /**
+     * Heartbeat interval in ms (default: 30000)
+     */
+    heartbeatInterval?: number;
+    /**
+     * Enable debug logging (default: false)
+     */
+    debug?: boolean;
+}
+
+export type { ChannelClient, ChannelClientOptions, ChannelConnection, ChannelServer, ChannelServerOptions, MinimalHTTPServer, Unsubscribe };

package/dist/network.js

@@ -0,0 +1 @@
+//# sourceMappingURL=network.js.map

package/dist/network.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/runtime-internal.cjs

@@ -0,0 +1,19 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/runtime/internal/index.ts
+var internal_exports = {};
+module.exports = __toCommonJS(internal_exports);
+//# sourceMappingURL=runtime-internal.cjs.map

package/dist/runtime-internal.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/runtime/internal/index.ts"],"sourcesContent":["/**\n * Runtime Internal Types\n *\n * Internal implementation types for runtime layer.\n * These are used by runtime implementers, not end users.\n *\n * ## Structure\n *\n * ```\n * internal/\n * ├── container/\n * │   ├── Container      # Agent lifecycle management\n * │   ├── llm/           # LLM connection (LLM, LLMConfig, TokenUsage...)\n * │   └── sandbox/       # Isolated environment\n * │       ├── Sandbox    # Workdir + MCP access\n * │       ├── workdir/   # File system operations\n * │       └── mcp/       # MCP tools, resources, prompts\n * │\n * ├── environment/\n * │   ├── Environment    # External world abstraction\n * │   ├── Receptor       # Event producer (LLM → DriveableEvent)\n * │   └── Effector       # Action executor (ToolCall → ToolResult)\n * │\n * ├── session/\n * │   └── Session        # Message persistence per Agent\n * │\n * ├── event/\n * │   └── SystemBus      # Central event bus\n * │\n * └── persistence/\n *     ├── Persistence    # Storage facade\n *     ├── Repository     # Flat storage interface\n *     └── record/        # Storage schema types\n * ```\n *\n * @packageDocumentation\n */\n\n// ============================================================================\n// Container\n// ============================================================================\n\nexport type { Container } from \"./container/Container\";\n\n// Sandbox\nexport type { Sandbox } from \"./container/sandbox/Sandbox\";\nexport type { Workdir } from \"./container/sandbox/workdir/Workdir\";\nexport type {\n  McpServerInfo,\n  McpTool,\n  McpResource,\n  McpPrompt,\n  McpRequest,\n  McpTransportConfig,\n  McpProtocolVersion,\n} from \"./container/sandbox/mcp\";\n\n// LLM\nexport type {\n  LLM,\n  LLMConfig,\n  LLMProvider,\n  LLMRequest,\n  LLMResponse,\n  StreamChunk,\n  StopReason,\n  TokenUsage,\n} from \"./container/llm\";\n\n// ============================================================================\n// Environment\n// ============================================================================\n\nexport type { Environment } from \"./environment/Environment\";\nexport type { Receptor } from \"./environment/Receptor\";\nexport type { Effector } from \"./environment/Effector\";\n\n// ============================================================================\n// Session\n// ============================================================================\n\nexport type { Session } from \"./session/Session\";\n\n// ============================================================================\n// Event Bus (Runtime internal)\n// ============================================================================\n\nexport type { SystemBus, BusEventHandler, SubscribeOptions, Unsubscribe } from \"./event/SystemBus\";\nexport type { SystemBusProducer } from \"./event/SystemBusProducer\";\nexport type { SystemBusConsumer } from \"./event/SystemBusConsumer\";\n\n// ============================================================================\n// Event Handler\n// ============================================================================\n\nexport type { ErrorContext } from \"./EventHandler\";\n\n// ============================================================================\n// Persistence\n// ============================================================================\n\nexport * from \"./persistence\";\n"],"mappings":";;;;;;;;;;;;;;;;AAAA;AAAA;","names":[]}