@elizaos/server 1.4.4 → 1.5.0

package/dist/api/shared/index.d.ts

@@ -0,0 +1,7 @@
+export * from './response-utils';
+export * from './validation';
+export * from './file-utils';
+export * from './middleware';
+export * from './uploads';
+export * from './constants';
+//# sourceMappingURL=index.d.ts.map

package/dist/api/shared/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/api/shared/index.ts"],"names":[],"mappings":"AACA,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC"}

package/dist/api/shared/middleware.d.ts

@@ -0,0 +1,40 @@
+import type { IAgentRuntime, UUID } from '@elizaos/core';
+import express from 'express';
+/**
+ * Middleware to validate that an agent exists
+ */
+export declare const agentExistsMiddleware: (agents: Map<UUID, IAgentRuntime>) => (req: express.Request, res: express.Response, next: express.NextFunction) => void;
+/**
+ * Middleware to validate UUID parameters
+ */
+export declare const validateUuidMiddleware: (paramName: string) => (req: express.Request, res: express.Response, next: express.NextFunction) => void;
+/**
+ * Enhanced channel ID validation middleware with additional security
+ */
+export declare const validateChannelIdMiddleware: () => (req: express.Request, res: express.Response, next: express.NextFunction) => void;
+/**
+ * Security middleware to add additional API protection
+ */
+export declare const securityMiddleware: () => (req: express.Request, res: express.Response, next: express.NextFunction) => void;
+/**
+ * Middleware to validate request content type for POST/PUT/PATCH requests
+ */
+export declare const validateContentTypeMiddleware: () => (req: express.Request, res: express.Response, next: express.NextFunction) => void;
+/**
+ * General API rate limiting middleware
+ */
+export declare const createApiRateLimit: () => import("express-rate-limit").RateLimitRequestHandler;
+/**
+ * Strict rate limiting for file system operations
+ */
+export declare const createFileSystemRateLimit: () => import("express-rate-limit").RateLimitRequestHandler;
+/**
+ * Very strict rate limiting for upload operations
+ */
+export declare const createUploadRateLimit: () => import("express-rate-limit").RateLimitRequestHandler;
+/**
+ * Rate limiting specifically for channel validation attempts
+ * Prevents brute force attacks on channel IDs
+ */
+export declare const createChannelValidationRateLimit: () => import("express-rate-limit").RateLimitRequestHandler;
+//# sourceMappingURL=middleware.d.ts.map

package/dist/api/shared/middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../../../src/api/shared/middleware.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,OAAO,MAAM,SAAS,CAAC;AAM9B;;GAEG;AACH,eAAO,MAAM,qBAAqB,GAAI,QAAQ,GAAG,CAAC,IAAI,EAAE,aAAa,CAAC,MAC5D,KAAK,OAAO,CAAC,OAAO,EAAE,KAAK,OAAO,CAAC,QAAQ,EAAE,MAAM,OAAO,CAAC,YAAY,SAgBhF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,sBAAsB,GAAI,WAAW,MAAM,MAC9C,KAAK,OAAO,CAAC,OAAO,EAAE,KAAK,OAAO,CAAC,QAAQ,EAAE,MAAM,OAAO,CAAC,YAAY,SAuBhF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,2BAA2B,SAC9B,KAAK,OAAO,CAAC,OAAO,EAAE,KAAK,OAAO,CAAC,QAAQ,EAAE,MAAM,OAAO,CAAC,YAAY,SAoBhF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,kBAAkB,SACrB,KAAK,OAAO,CAAC,OAAO,EAAE,KAAK,OAAO,CAAC,QAAQ,EAAE,MAAM,OAAO,CAAC,YAAY,SAqEhF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,6BAA6B,SAChC,KAAK,OAAO,CAAC,OAAO,EAAE,KAAK,OAAO,CAAC,QAAQ,EAAE,MAAM,OAAO,CAAC,YAAY,SA8BhF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,kBAAkB,4DAyB9B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,yBAAyB,4DA2BrC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,qBAAqB,4DA2BjC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,gCAAgC,4DAqC5C,CAAC"}

package/dist/api/shared/response-utils.d.ts

@@ -0,0 +1,10 @@
+import express from 'express';
+/**
+ * Sends a standardized error response
+ */
+export declare const sendError: (res: express.Response, status: number, code: string, message: string, details?: string) => void;
+/**
+ * Sends a standardized success response
+ */
+export declare const sendSuccess: (res: express.Response, data: any, status?: number) => void;
+//# sourceMappingURL=response-utils.d.ts.map

package/dist/api/shared/response-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-utils.d.ts","sourceRoot":"","sources":["../../../src/api/shared/response-utils.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,SAAS,CAAC;AAE9B;;GAEG;AACH,eAAO,MAAM,SAAS,GACpB,KAAK,OAAO,CAAC,QAAQ,EACrB,QAAQ,MAAM,EACd,MAAM,MAAM,EACZ,SAAS,MAAM,EACf,UAAU,MAAM,SAUjB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,WAAW,GAAI,KAAK,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,EAAE,eAAY,SAKzE,CAAC"}

package/dist/api/shared/uploads/index.d.ts

@@ -0,0 +1,2 @@
+export { agentAudioUpload, agentMediaUpload, channelUpload, validateAudioFile, validateMediaFile, processUploadedFile, generateSecureFilename, ensureUploadDir, } from '../../../upload';
+//# sourceMappingURL=index.d.ts.map

package/dist/api/shared/uploads/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/api/shared/uploads/index.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,EACb,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,EACnB,sBAAsB,EACtB,eAAe,GAChB,MAAM,iBAAiB,CAAC"}

package/dist/api/shared/validation.d.ts

@@ -0,0 +1,27 @@
+import type { IAgentRuntime, UUID } from '@elizaos/core';
+/**
+ * Validates and retrieves an agent runtime from the agents map
+ */
+export declare const getRuntime: (agents: Map<UUID, IAgentRuntime>, agentId: UUID) => IAgentRuntime;
+/**
+ * Validates a UUID parameter and returns it as UUID type or null if invalid
+ */
+export declare const validateAgentId: (agentId: string) => UUID | null;
+/**
+ * Validates a room ID parameter
+ */
+export declare const validateRoomId: (roomId: string) => UUID | null;
+/**
+ * Enhanced channel ID validation with security logging
+ * Validates a channel ID parameter with additional security checks
+ */
+export declare const validateChannelId: (channelId: string, clientIp?: string) => UUID | null;
+/**
+ * Validates a memory ID parameter
+ */
+export declare const validateMemoryId: (memoryId: string) => UUID | null;
+/**
+ * Validates a world ID parameter
+ */
+export declare const validateWorldId: (worldId: string) => UUID | null;
+//# sourceMappingURL=validation.d.ts.map

package/dist/api/shared/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../src/api/shared/validation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAGzD;;GAEG;AACH,eAAO,MAAM,UAAU,GAAI,QAAQ,GAAG,CAAC,IAAI,EAAE,aAAa,CAAC,EAAE,SAAS,IAAI,kBAMzE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe,GAAI,SAAS,MAAM,KAAG,IAAI,GAAG,IAExD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,cAAc,GAAI,QAAQ,MAAM,KAAG,IAAI,GAAG,IAEtD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAAI,WAAW,MAAM,EAAE,WAAW,MAAM,KAAG,IAAI,GAAG,IAwB/E,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,GAAI,UAAU,MAAM,KAAG,IAAI,GAAG,IAE1D,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe,GAAI,SAAS,MAAM,KAAG,IAAI,GAAG,IAExD,CAAC"}

package/dist/api/system/environment.d.ts

@@ -0,0 +1,24 @@
+import express from 'express';
+export type EnvVars = Record<string, string>;
+/**
+ * Parse an .env file and return the key-value pairs
+ * @param filePath Path to the .env file
+ * @returns Object containing the key-value pairs
+ */
+export declare function parseEnvFile(filePath: string): Promise<EnvVars>;
+/**
+ * Resolves the path to the nearest `.env` file.
+ *
+ * If no `.env` file is found when traversing up from the starting directory,
+ * a path to `.env` in the starting directory is returned.
+ *
+ * @param startDir - The directory to start searching from. Defaults to the
+ *   current working directory.
+ * @returns The resolved path to the `.env` file.
+ */
+export declare function resolveEnvFile(startDir?: string): string;
+/**
+ * Environment configuration management
+ */
+export declare function createEnvironmentRouter(): express.Router;
+//# sourceMappingURL=environment.d.ts.map

package/dist/api/system/environment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment.d.ts","sourceRoot":"","sources":["../../../src/api/system/environment.ts"],"names":[],"mappings":"AACA,OAAO,OAAO,MAAM,SAAS,CAAC;AAM9B,MAAM,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAE7C;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAgBrE;AAaD;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,QAAQ,GAAE,MAAsB,GAAG,MAAM,CAiBvE;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,OAAO,CAAC,MAAM,CAgFxD"}

package/dist/api/system/index.d.ts

@@ -0,0 +1,6 @@
+import express from 'express';
+/**
+ * Creates the system router for configuration and environment management
+ */
+export declare function systemRouter(): express.Router;
+//# sourceMappingURL=index.d.ts.map

package/dist/api/system/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/api/system/index.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,SAAS,CAAC;AAI9B;;GAEG;AACH,wBAAgB,YAAY,IAAI,OAAO,CAAC,MAAM,CAU7C"}

package/dist/api/system/version.d.ts

@@ -0,0 +1,6 @@
+import express from 'express';
+/**
+ * Creates the version router for system version information
+ */
+export declare function createVersionRouter(): express.Router;
+//# sourceMappingURL=version.d.ts.map

package/dist/api/system/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../../src/api/system/version.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,SAAS,CAAC;AAwC9B;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,OAAO,CAAC,MAAM,CAYpD"}

package/dist/api/tee/index.d.ts

@@ -0,0 +1,6 @@
+import express from 'express';
+/**
+ * Creates the security router for TEE and security operations
+ */
+export declare function teeRouter(): express.Router;
+//# sourceMappingURL=index.d.ts.map

package/dist/api/tee/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/api/tee/index.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,SAAS,CAAC;AAG9B;;GAEG;AACH,wBAAgB,SAAS,IAAI,OAAO,CAAC,MAAM,CAO1C"}

package/dist/api/tee/tee.d.ts

@@ -0,0 +1 @@
+//# sourceMappingURL=tee.d.ts.map

package/dist/api/tee/tee.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tee.d.ts","sourceRoot":"","sources":["../../../src/api/tee/tee.ts"],"names":[],"mappings":""}

package/dist/authMiddleware.d.ts

@@ -0,0 +1,16 @@
+import { type Request, type Response, type NextFunction } from 'express';
+/**
+ * Express middleware for validating API Key authentication based on an environment variable.
+ *
+ * If the ELIZA_SERVER_AUTH_TOKEN environment variable is set, this middleware
+ * checks for a matching 'X-API-KEY' header in incoming requests.
+ *
+ * If the environment variable is *not* set, the middleware allows all requests
+ * to pass through without authentication checks.
+ *
+ * @param req - Express request object.
+ * @param res - Express response object.
+ * @param next - Express next function.
+ */
+export declare function apiKeyAuthMiddleware(req: Request, res: Response, next: NextFunction): void | Response<any, Record<string, any>>;
+//# sourceMappingURL=authMiddleware.d.ts.map

package/dist/authMiddleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"authMiddleware.d.ts","sourceRoot":"","sources":["../src/authMiddleware.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,OAAO,EAAE,KAAK,QAAQ,EAAE,KAAK,YAAY,EAAE,MAAM,SAAS,CAAC;AAGzE;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,6CAsBnF"}

package/dist/bus.d.ts

@@ -0,0 +1,31 @@
+/**
+ * A simple in-memory message bus for distributing messages from the server
+ * to subscribed MessageBusService instances within the same process.
+ *
+ * For multi-process or multi-server deployments, this would need to be replaced
+ * with a more robust solution like Redis Pub/Sub, Kafka, RabbitMQ, etc.
+ *
+ * Uses Bun-native EventTarget internally but maintains EventEmitter-like API.
+ *
+ * NOTE: This implementation uses a class extending EventTarget rather than functional
+ * patterns because EventTarget is a native browser/Bun API that requires class inheritance.
+ * This is an intentional architectural decision to leverage Bun's native capabilities
+ * instead of Node.js EventEmitter for better compatibility.
+ *
+ * NOTE: Unlike standard EventEmitter, this implementation prevents duplicate handler
+ * registration. This is an intentional design choice to prevent memory leaks and
+ * unintended multiple executions of the same handler.
+ */
+declare class InternalMessageBus extends EventTarget {
+    private _maxListeners;
+    private handlers;
+    emit(event: string, data: unknown): boolean;
+    on(event: string, handler: (data: unknown) => void): this;
+    off(event: string, handler: (data: unknown) => void): void;
+    getMaxListeners(): number;
+    setMaxListeners(n: number): void;
+    removeAllListeners(event?: string): void;
+}
+declare const internalMessageBus: InternalMessageBus;
+export default internalMessageBus;
+//# sourceMappingURL=bus.d.ts.map

package/dist/bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bus.d.ts","sourceRoot":"","sources":["../src/bus.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,cAAM,kBAAmB,SAAQ,WAAW;IAC1C,OAAO,CAAC,aAAa,CAAc;IACnC,OAAO,CAAC,QAAQ,CAAkE;IAElF,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO;IAI3C,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI;IA6BzD,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI;IAenD,eAAe,IAAI,MAAM;IAIzB,eAAe,CAAC,CAAC,EAAE,MAAM;IAMzB,kBAAkB,CAAC,KAAK,CAAC,EAAE,MAAM;CAoBlC;AAED,QAAA,MAAM,kBAAkB,oBAA2B,CAAC;AAKpD,eAAe,kBAAkB,CAAC"}

package/dist/index.d.ts

@@ -1,262 +1,16 @@
-import { UUID, ChannelType, Character, DatabaseAdapter, IAgentRuntime } from '@elizaos/core';
+import { type Character, DatabaseAdapter, type IAgentRuntime, type UUID } from '@elizaos/core';
 import express from 'express';
 import http from 'node:http';
-import { Server } from 'socket.io';
-
-/**
- * Session timeout configuration
- */
-interface SessionTimeoutConfig {
-    /** Timeout in minutes. If not specified, uses agent or global default */
-    timeoutMinutes?: number;
-    /** Whether to auto-renew the session on activity */
-    autoRenew?: boolean;
-    /** Maximum session duration in minutes (even with renewals) */
-    maxDurationMinutes?: number;
-    /** Warning threshold in minutes before timeout */
-    warningThresholdMinutes?: number;
-}
-/**
- * Metadata associated with a session
- */
-interface SessionMetadata {
-    platform?: string;
-    username?: string;
-    discriminator?: string;
-    avatar?: string;
-    [key: string]: string | number | boolean | undefined;
-}
-/**
- * Represents a messaging session between a user and an agent
- */
-interface Session {
-    id: string;
-    agentId: UUID;
-    channelId: UUID;
-    userId: UUID;
-    metadata: SessionMetadata;
-    createdAt: Date;
-    lastActivity: Date;
-    /** Session expiration time */
-    expiresAt: Date;
-    /** Session timeout configuration */
-    timeoutConfig: SessionTimeoutConfig;
-    /** Number of times the session has been renewed */
-    renewalCount: number;
-    /** Whether a warning has been sent about upcoming expiration */
-    warningState?: {
-        sent: boolean;
-        sentAt?: Date;
-    };
-}
-/**
- * Request body for creating a session
- */
-interface CreateSessionRequest {
-    agentId: string;
-    userId: string;
-    metadata?: SessionMetadata;
-    /** Optional timeout configuration for this session */
-    timeoutConfig?: SessionTimeoutConfig;
-}
-/**
- * Response for session creation
- */
-interface CreateSessionResponse {
-    sessionId: string;
-    agentId: UUID;
-    userId: UUID;
-    createdAt: Date;
-    metadata: SessionMetadata;
-    /** When the session will expire */
-    expiresAt: Date;
-    /** Session timeout configuration */
-    timeoutConfig: SessionTimeoutConfig;
-}
-/**
- * Request body for sending a message
- */
-interface SendMessageRequest {
-    content: string;
-    attachments?: Array<{
-        type: string;
-        url: string;
-        name?: string;
-    }>;
-    metadata?: Record<string, any>;
-}
-/**
- * Query parameters for retrieving messages
- */
-interface GetMessagesQuery {
-    limit?: string;
-    before?: string;
-    after?: string;
-}
-/**
- * Simplified message format for API responses
- */
-interface SimplifiedMessage {
-    id: string;
-    content: string;
-    authorId: string;
-    isAgent: boolean;
-    createdAt: Date;
-    metadata: {
-        thought?: string;
-        actions?: string[];
-        [key: string]: any;
-    };
-}
-/**
- * Response for message retrieval
- */
-interface GetMessagesResponse {
-    messages: SimplifiedMessage[];
-    hasMore: boolean;
-    /** Pagination cursors for navigating through messages */
-    cursors?: {
-        /** Timestamp to use for getting older messages (pagination backward) */
-        before?: number;
-        /** Timestamp to use for getting newer messages (pagination forward) */
-        after?: number;
-    };
-}
-/**
- * Session info response
- */
-interface SessionInfoResponse {
-    sessionId: string;
-    agentId: UUID;
-    userId: UUID;
-    createdAt: Date;
-    lastActivity: Date;
-    metadata: SessionMetadata;
-    /** When the session will expire */
-    expiresAt: Date;
-    /** Session timeout configuration */
-    timeoutConfig: SessionTimeoutConfig;
-    /** Number of times the session has been renewed */
-    renewalCount: number;
-    /** Time remaining in milliseconds */
-    timeRemaining: number;
-    /** Whether the session is near expiration */
-    isNearExpiration: boolean;
-}
-/**
- * Health check response
- */
-interface HealthCheckResponse {
-    status: 'healthy' | 'unhealthy';
-    activeSessions: number;
-    timestamp: string;
-}
-
-interface MessageServer {
-    id: UUID;
-    name: string;
-    sourceType: string;
-    sourceId?: string;
-    metadata?: Record<string, any>;
-    createdAt: Date;
-    updatedAt: Date;
-}
-interface MessageChannel {
-    id: UUID;
-    messageServerId: UUID;
-    name: string;
-    type: ChannelType;
-    sourceType?: string;
-    sourceId?: string;
-    topic?: string;
-    metadata?: Record<string, any>;
-    createdAt: Date;
-    updatedAt: Date;
-}
-interface CentralRootMessage {
-    id: UUID;
-    channelId: UUID;
-    authorId: UUID;
-    content: string;
-    rawMessage?: any;
-    inReplyToRootMessageId?: UUID;
-    sourceType?: string;
-    sourceId?: string;
-    createdAt: Date;
-    updatedAt: Date;
-    metadata?: Record<string, any>;
-}
-interface MessageServiceStructure {
-    id: UUID;
-    channel_id: UUID;
-    server_id: UUID;
-    author_id: UUID;
-    author_display_name?: string;
-    content: string;
-    raw_message?: any;
-    source_id?: string;
-    source_type?: string;
-    in_reply_to_message_id?: UUID;
-    created_at: number;
-    metadata?: any;
-}
-
-/**
- * Attempts to load a file from the given file path.
- *
- * @param {string} filePath - The path to the file to load.
- * @returns {string | null} The contents of the file as a string, or null if an error occurred.
- * @throws {Error} If an error occurs while loading the file.
- */
-declare function tryLoadFile(filePath: string): string | null;
-/**
- * Load characters from a specified URL and return them as an array of Character objects.
- * @param {string} url - The URL from which to load character data.
- * @returns {Promise<Character[]>} - A promise that resolves with an array of Character objects.
- */
-declare function loadCharactersFromUrl(url: string): Promise<Character[]>;
-/**
- * Converts a JSON object representing a character into a validated Character object with additional settings and secrets.
- *
- * @param {unknown} character - The input data representing a character.
- * @returns {Promise<Character>} - A Promise that resolves to a validated Character object.
- * @throws {Error} If character validation fails.
- */
-declare function jsonToCharacter(character: unknown): Promise<Character>;
-/**
- * Loads a character from the specified file path with safe JSON parsing and validation.
- *
- * @param {string} filePath - The path to the character file.
- * @returns {Promise<Character>} A Promise that resolves to the validated Character object.
- * @throws {Error} If the character file is not found, has invalid JSON, or fails validation.
- */
-declare function loadCharacter(filePath: string): Promise<Character>;
-/**
- * Asynchronously loads a character from the specified path.
- * If the path is a URL, it loads the character from the URL.
- * If the path is a local file path, it tries multiple possible locations and
- * loads the character from the first valid location found.
- *
- * @param {string} characterPath - The path to load the character from.
- * @returns {Promise<Character>} A Promise that resolves to the loaded character.
- */
-declare function loadCharacterTryPath(characterPath: string): Promise<Character>;
-declare const hasValidRemoteUrls: () => boolean | "" | undefined;
-/**
- * Load characters from local paths or remote URLs based on configuration.
- * @param charactersArg - A comma-separated list of local file paths or remote URLs to load characters from.
- * @returns A promise that resolves to an array of loaded characters.
- */
-declare function loadCharacters(charactersArg: string): Promise<Character[]>;
-
+import { Server as SocketIOServer } from 'socket.io';
+import type { CentralRootMessage, MessageChannel, MessageServer } from './types.js';
 /**
  * Expands a file path starting with `~` to the project directory.
  *
  * @param filepath - The path to expand.
  * @returns The expanded path.
  */
-declare function expandTildePath(filepath: string): string;
-declare function resolvePgliteDir(dir?: string, fallbackDir?: string): string;
+export declare function expandTildePath(filepath: string): string;
+export declare function resolvePgliteDir(dir?: string, fallbackDir?: string): string;
 /**
  * Represents a function that acts as a server middleware.
  * @param {express.Request} req - The request object.
@@ -264,7 +18,7 @@ declare function resolvePgliteDir(dir?: string, fallbackDir?: string): string;
  * @param {express.NextFunction} next - The next function to be called in the middleware chain.
  * @returns {void}
  */
-type ServerMiddleware = (req: express.Request, res: express.Response, next: express.NextFunction) => void;
+export type ServerMiddleware = (req: express.Request, res: express.Response, next: express.NextFunction) => void;
 /**
  * Interface for defining server configuration options.
  * @typedef {Object} ServerOptions
@@ -272,7 +26,7 @@ type ServerMiddleware = (req: express.Request, res: express.Response, next: expr
  * @property {string} [dataDir] - Optional directory for storing server data.
  * @property {string} [postgresUrl] - Optional URL for connecting to a PostgreSQL database.
  */
-interface ServerOptions {
+export interface ServerOptions {
     middlewares?: ServerMiddleware[];
     dataDir?: string;
     postgresUrl?: string;
@@ -283,17 +37,17 @@ interface ServerOptions {
  *
  * @returns {boolean} - Returns true if UI should be enabled, false otherwise
  */
-declare function isWebUIEnabled(): boolean;
+export declare function isWebUIEnabled(): boolean;
 /**
  * Class representing an agent server.
  */ /**
 * Represents an agent server which handles agents, database, and server functionalities.
 */
-declare class AgentServer {
+export declare class AgentServer {
     app: express.Application;
     private agents;
     server: http.Server;
-    socketIO: Server;
+    socketIO: SocketIOServer;
     isInitialized: boolean;
     private isWebUIEnabled;
     private clientPath?;
@@ -409,5 +163,6 @@ declare class AgentServer {
      */
     private registerSignalHandlers;
 }
-
-export { AgentServer, type CentralRootMessage, type CreateSessionRequest, type CreateSessionResponse, type GetMessagesQuery, type GetMessagesResponse, type HealthCheckResponse, type MessageChannel, type MessageServer, type MessageServiceStructure, type SendMessageRequest, type ServerMiddleware, type ServerOptions, type Session, type SessionInfoResponse, type SessionMetadata, type SessionTimeoutConfig, type SimplifiedMessage, expandTildePath, hasValidRemoteUrls, isWebUIEnabled, jsonToCharacter, loadCharacter, loadCharacterTryPath, loadCharacters, loadCharactersFromUrl, resolvePgliteDir, tryLoadFile };
+export { tryLoadFile, loadCharactersFromUrl, jsonToCharacter, loadCharacter, loadCharacterTryPath, hasValidRemoteUrls, loadCharacters, } from './loader';
+export * from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}