@elizaos/core 2.0.0-alpha.21 → 2.0.0-alpha.22

package/dist/database.d.ts

@@ -0,0 +1,433 @@
+import type { Agent, Component, Entity, IDatabaseAdapter, JsonValue, Log, LogBody, Memory, MemoryMetadata, Metadata, PairingAllowlistEntry, PairingChannel, PairingRequest, Participant, ParticipantUpdateFields, ParticipantUserState, PatchOp, Relationship, Room, Task, UUID, World } from "./types";
+/**
+ * Abstract base class for database adapters.
+ *
+ * WHY this exists as an abstract class (not just the IDatabaseAdapter interface):
+ * - Provides a single place for JSDoc on every abstract method, so adapter
+ *   authors get documentation in their IDE without reading the interface.
+ * - Serves as the compile-time contract: if you extend this class and miss
+ *   a method, TypeScript tells you immediately.
+ * - Does NOT contain any implementation logic. All implementations live in
+ *   concrete adapters (plugin-sql's Drizzle adapters, InMemoryDatabaseAdapter,
+ *   etc.). This is intentional -- core must not depend on any ORM.
+ *
+ * All CRUD methods are batch-first (arrays in, arrays out). See
+ * IDatabaseAdapter in types/database.ts for the full design rationale.
+ *
+ * @template DB - The type of the database instance (e.g. PgDatabase, BetterSQLite3Database).
+ * @abstract
+ */
+export declare abstract class DatabaseAdapter<DB extends object = object> implements IDatabaseAdapter<DB> {
+    /**
+     * The database instance.
+     */
+    db: DB;
+    /**
+     * Initialize the database adapter.
+     * @param config - Optional configuration object
+     * @returns A Promise that resolves when initialization is complete.
+     */
+    abstract initialize(config?: Record<string, string | number | boolean | null>): Promise<void>;
+    /**
+     * Initialize the database adapter.
+     * @returns A Promise that resolves when initialization is complete.
+     */
+    /**
+     * Run plugin schema migrations for all registered plugins
+     * @param plugins Array of plugins with their schemas
+     * @param options Migration options (verbose, force, dryRun, etc.)
+     * @returns A Promise that resolves when migrations are complete.
+     */
+    abstract runPluginMigrations(plugins: Array<{
+        name: string;
+        schema?: Record<string, JsonValue>;
+    }>, options?: {
+        verbose?: boolean;
+        force?: boolean;
+        dryRun?: boolean;
+    }): Promise<void>;
+    /**
+     * Check if the database connection is ready.
+     * @returns A Promise that resolves to true if the database is ready, false otherwise.
+     */
+    abstract isReady(): Promise<boolean>;
+    /**
+     * Optional close method for the database adapter.
+     * @returns A Promise that resolves when closing is complete.
+     */
+    abstract close(): Promise<void>;
+    /**
+     * Retrieves a connection to the database.
+     * @returns A Promise that resolves to the database connection.
+     */
+    abstract getConnection(): Promise<DB>;
+    /**
+     * Execute a callback within a database transaction.
+     * InMemory adapter runs the callback directly without atomicity guarantees.
+     * @param options.entityContext When set (Postgres + ENABLE_DATA_ISOLATION), runs under RLS for this entity.
+     */
+    abstract transaction<T>(callback: (tx: IDatabaseAdapter<DB>) => Promise<T>, options?: {
+        entityContext?: UUID;
+    }): Promise<T>;
+    abstract getEntitiesForRooms(roomIds: UUID[], includeComponents?: boolean): Promise<import("./types").EntitiesForRoomsResult>;
+    /**
+     * Creates a new entities in the database.
+     * @param entities The entity objects to create.
+     * @returns A Promise that resolves when the account creation is complete.
+     */
+    abstract createEntities(entities: Entity[]): Promise<UUID[]>;
+    /**
+     * Upsert entities (insert or update by ID).
+     * @param entities - An array of entities to upsert (ID required for each).
+     * @returns A Promise that resolves when the upsert is complete.
+     */
+    abstract upsertEntities(entities: Entity[]): Promise<void>;
+    /**
+     * Search entities by name substring match.
+     * @param params - Search parameters (query, agentId, limit).
+     * @returns A Promise that resolves to matching entities.
+     */
+    abstract searchEntitiesByName(params: {
+        query: string;
+        agentId: UUID;
+        limit?: number;
+    }): Promise<Entity[]>;
+    /**
+     * Get entities by exact name match.
+     * @param params - Lookup parameters (names array, agentId).
+     * @returns A Promise that resolves to matching entities.
+     */
+    abstract getEntitiesByNames(params: {
+        names: string[];
+        agentId: UUID;
+    }): Promise<Entity[]>;
+    /**
+     * Query entities by component type and optional JSONB data filter.
+     * @param params.entityContext RLS only: when set (Postgres + ENABLE_DATA_ISOLATION), query runs under this entity context. WHY optional: adapters that don't support RLS accept and ignore it.
+     */
+    abstract queryEntities(params: {
+        componentType?: string;
+        componentDataFilter?: Record<string, unknown>;
+        agentId?: UUID;
+        entityIds?: UUID[];
+        worldId?: UUID;
+        limit?: number;
+        offset?: number;
+        includeAllComponents?: boolean;
+        entityContext?: UUID;
+    }): Promise<Entity[]>;
+    abstract getComponentsByNaturalKeys(keys: Array<{
+        entityId: UUID;
+        type: string;
+        worldId?: UUID;
+        sourceEntityId?: UUID;
+    }>): Promise<(Component | null)[]>;
+    abstract getComponentsForEntities(entityIds: UUID[], worldId?: UUID, sourceEntityId?: UUID): Promise<Component[]>;
+    abstract getEntitiesByIds(entityIds: UUID[]): Promise<Entity[]>;
+    abstract updateEntities(entities: Entity[]): Promise<void>;
+    abstract deleteEntities(entityIds: UUID[]): Promise<void>;
+    abstract createComponents(components: Component[]): Promise<UUID[]>;
+    abstract getComponentsByIds(componentIds: UUID[]): Promise<Component[]>;
+    abstract updateComponents(components: Component[]): Promise<void>;
+    abstract deleteComponents(componentIds: UUID[]): Promise<void>;
+    /**
+     * Upsert components (insert or update by natural key).
+     * @param options.entityContext When set (Postgres + ENABLE_DATA_ISOLATION), runs under RLS for this entity.
+     */
+    abstract upsertComponents(components: Component[], options?: {
+        entityContext?: UUID;
+    }): Promise<void>;
+    abstract patchComponents(updates: Array<{
+        componentId: UUID;
+        ops: PatchOp[];
+    }>, options?: {
+        entityContext?: UUID;
+    }): Promise<void>;
+    /**
+     * Retrieves memories based on the specified parameters.
+     * @param params An object containing parameters for the memory retrieval.
+     * @returns A Promise that resolves to an array of Memory objects.
+     */
+    abstract getMemories(params: {
+        entityId?: UUID;
+        agentId?: UUID;
+        /** @deprecated use limit */
+        count?: number;
+        limit?: number;
+        offset?: number;
+        unique?: boolean;
+        tableName: string;
+        start?: number;
+        end?: number;
+        roomId?: UUID;
+        worldId?: UUID;
+        metadata?: Record<string, unknown>;
+    }): Promise<Memory[]>;
+    abstract getMemoriesByRoomIds(params: {
+        roomIds: UUID[];
+        tableName: string;
+        limit?: number;
+    }): Promise<Memory[]>;
+    /**
+     * Retrieves multiple memories by their IDs
+     * @param memoryIds Array of UUIDs of the memories to retrieve
+     * @param tableName Optional table name to filter memories by type
+     * @returns Promise resolving to array of Memory objects
+     */
+    abstract getMemoriesByIds(memoryIds: UUID[], tableName?: string): Promise<Memory[]>;
+    /**
+     * Retrieves cached embeddings based on the specified query parameters.
+     * @param params An object containing parameters for the embedding retrieval.
+     * @returns A Promise that resolves to an array of objects containing embeddings and levenshtein scores.
+     */
+    abstract getCachedEmbeddings({ query_table_name, query_threshold, query_input, query_field_name, query_field_sub_name, query_match_count, }: {
+        query_table_name: string;
+        query_threshold: number;
+        query_input: string;
+        query_field_name: string;
+        query_field_sub_name: string;
+        query_match_count: number;
+    }): Promise<{
+        embedding: number[];
+        levenshtein_score: number;
+    }[]>;
+    /**
+     * Retrieves logs based on the specified parameters.
+     * @param params An object containing parameters for the log retrieval.
+     * @returns A Promise that resolves to an array of Log objects.
+     */
+    abstract getLogs(params: {
+        entityId?: UUID;
+        roomId?: UUID;
+        type?: string;
+        /** @deprecated use limit */
+        count?: number;
+        limit?: number;
+        offset?: number;
+    }): Promise<Log[]>;
+    abstract createLogs(params: Array<{
+        body: LogBody;
+        entityId: UUID;
+        roomId: UUID;
+        type: string;
+    }>): Promise<void>;
+    abstract getLogsByIds(logIds: UUID[]): Promise<Log[]>;
+    abstract updateLogs(logs: Array<{
+        id: UUID;
+        updates: Partial<Log>;
+    }>): Promise<void>;
+    abstract deleteLogs(logIds: UUID[]): Promise<void>;
+    /**
+     * Searches for memories based on embeddings and other specified parameters.
+     * @param params An object containing parameters for the memory search.
+     * @returns A Promise that resolves to an array of Memory objects.
+     */
+    abstract searchMemories(params: {
+        tableName: string;
+        embedding: number[];
+        match_threshold?: number;
+        /** @deprecated use limit */
+        count?: number;
+        limit?: number;
+        unique?: boolean;
+        query?: string;
+        roomId?: UUID;
+        worldId?: UUID;
+        entityId?: UUID;
+    }): Promise<Memory[]>;
+    abstract createMemories(memories: Array<{
+        memory: Memory;
+        tableName: string;
+        unique?: boolean;
+    }>): Promise<UUID[]>;
+    abstract updateMemories(memories: Array<Partial<Memory> & {
+        id: UUID;
+        metadata?: MemoryMetadata;
+    }>): Promise<void>;
+    /**
+     * Upsert memories (insert or update by ID).
+     * @param options.entityContext When set (Postgres + ENABLE_DATA_ISOLATION), runs under RLS for this entity.
+     */
+    abstract upsertMemories(memories: Array<{
+        memory: Memory;
+        tableName: string;
+    }>, options?: {
+        entityContext?: UUID;
+    }): Promise<void>;
+    abstract deleteMemories(memoryIds: UUID[]): Promise<void>;
+    abstract deleteAllMemories(roomIds: UUID[], tableName: string): Promise<void>;
+    abstract countMemories(params: {
+        roomIds?: UUID[];
+        unique?: boolean;
+        tableName?: string;
+        entityId?: UUID;
+        agentId?: UUID;
+        metadata?: Record<string, unknown>;
+    }): Promise<number>;
+    /**
+     * Retrieves all worlds for an agent.
+     * @returns A Promise that resolves to an array of World objects.
+     */
+    abstract getAllWorlds(): Promise<World[]>;
+    abstract getWorldsByIds(worldIds: UUID[]): Promise<World[]>;
+    abstract createWorlds(worlds: World[]): Promise<UUID[]>;
+    abstract deleteWorlds(worldIds: UUID[]): Promise<void>;
+    abstract updateWorlds(worlds: World[]): Promise<void>;
+    /**
+     * Upsert worlds (insert or update by ID).
+     * @param worlds - An array of worlds to upsert (ID required for each).
+     * @returns A Promise that resolves when the upsert is complete.
+     */
+    abstract upsertWorlds(worlds: World[]): Promise<void>;
+    /**
+     * Retrieves the room ID for a given room, if it exists.
+     * @param roomIds The UUIDs of the rooms to retrieve.
+     * @returns A Promise that resolves to the room ID or null if not found.
+     */
+    abstract getRoomsByIds(roomIds: UUID[]): Promise<Room[]>;
+    abstract deleteRoomsByWorldIds(worldIds: UUID[]): Promise<void>;
+    abstract getRoomsForParticipants(entityIds: UUID[]): Promise<UUID[]>;
+    abstract getRoomsByWorlds(worldIds: UUID[], limit?: number, offset?: number): Promise<Room[]>;
+    /**
+     * Creates new rooms in the database.
+     * @param rooms Array of Room objects to create.
+     * @returns A Promise that resolves to the UUIDs of the created rooms.
+     */
+    abstract createRooms(rooms: Room[]): Promise<UUID[]>;
+    /**
+     * Upsert rooms (insert or update by ID).
+     * @param rooms - An array of rooms to upsert (ID required for each).
+     * @returns A Promise that resolves when the upsert is complete.
+     */
+    abstract upsertRooms(rooms: Room[]): Promise<void>;
+    /**
+     * Creates room participants for the specified entities.
+     * @param entityIds The UUIDs of the entities to add as participants.
+     * @param roomId The UUID of the room to which the entities will be added.
+     * @returns A Promise that resolves to the UUIDs of the created participant records.
+     */
+    abstract createRoomParticipants(entityIds: UUID[], roomId: UUID): Promise<UUID[]>;
+    /** WHY boolean: Callers need success/failure for error handling/UX; see IDatabaseAdapter in types/database.ts. */
+    abstract deleteParticipants(participants: Array<{
+        entityId: UUID;
+        roomId: UUID;
+    }>): Promise<boolean>;
+    abstract updateParticipants(participants: Array<{
+        entityId: UUID;
+        roomId: UUID;
+        updates: ParticipantUpdateFields;
+    }>): Promise<void>;
+    abstract updateRooms(rooms: Room[]): Promise<void>;
+    abstract deleteRooms(roomIds: UUID[]): Promise<void>;
+    abstract getParticipantsForEntities(entityIds: UUID[]): Promise<Participant[]>;
+    abstract getParticipantsForRooms(roomIds: UUID[]): Promise<import("./types").ParticipantsForRoomsResult>;
+    abstract areRoomParticipants(pairs: Array<{
+        roomId: UUID;
+        entityId: UUID;
+    }>): Promise<boolean[]>;
+    abstract getParticipantUserStates(pairs: Array<{
+        roomId: UUID;
+        entityId: UUID;
+    }>): Promise<ParticipantUserState[]>;
+    abstract updateParticipantUserStates(updates: Array<{
+        roomId: UUID;
+        entityId: UUID;
+        state: ParticipantUserState;
+    }>): Promise<void>;
+    abstract getRelationshipsByPairs(pairs: Array<{
+        sourceEntityId: UUID;
+        targetEntityId: UUID;
+    }>): Promise<(Relationship | null)[]>;
+    abstract getRelationships(params: {
+        entityIds?: UUID[];
+        tags?: string[];
+        limit?: number;
+        offset?: number;
+    }): Promise<Relationship[]>;
+    abstract createRelationships(relationships: Array<{
+        sourceEntityId: UUID;
+        targetEntityId: UUID;
+        tags?: string[];
+        metadata?: Metadata;
+    }>): Promise<UUID[]>;
+    abstract getRelationshipsByIds(relationshipIds: UUID[]): Promise<Relationship[]>;
+    abstract updateRelationships(relationships: Relationship[]): Promise<void>;
+    abstract deleteRelationships(relationshipIds: UUID[]): Promise<void>;
+    /**
+     * Retrieves all agents from the database.
+     * @returns A Promise that resolves to an array of Agent objects.
+     */
+    abstract getAgents(): Promise<Partial<Agent>[]>;
+    abstract getAgentsByIds(agentIds: UUID[]): Promise<Agent[]>;
+    abstract createAgents(agents: Partial<Agent>[]): Promise<UUID[]>;
+    /** WHY boolean: Success/failure signal for callers; see IDatabaseAdapter in types/database.ts. */
+    abstract updateAgents(updates: Array<{
+        agentId: UUID;
+        agent: Partial<Agent>;
+    }>): Promise<boolean>;
+    abstract upsertAgents(agents: Partial<Agent>[]): Promise<void>;
+    /** WHY boolean: Success/failure signal for callers; see IDatabaseAdapter in types/database.ts. */
+    abstract deleteAgents(agentIds: UUID[]): Promise<boolean>;
+    abstract countAgents(): Promise<number>;
+    abstract cleanupAgents(): Promise<void>;
+    /**
+     * Ensures an embedding dimension exists in the database.
+     * @param dimension The dimension to ensure exists.
+     * @returns A Promise that resolves when the embedding dimension has been ensured to exist.
+     */
+    abstract ensureEmbeddingDimension(dimension: number): Promise<void>;
+    abstract getCaches<T>(keys: string[]): Promise<Map<string, T>>;
+    abstract setCaches<T>(entries: Array<{
+        key: string;
+        value: T;
+    }>): Promise<boolean>;
+    abstract deleteCaches(keys: string[]): Promise<boolean>;
+    /**
+     * Retrieves tasks based on specified parameters.
+     * @param params Object containing optional roomId and tags to filter tasks
+     * @returns Promise resolving to an array of Task objects
+     */
+    abstract getTasks(params: {
+        roomId?: UUID;
+        tags?: string[];
+        entityId?: UUID;
+        agentIds: UUID[];
+        limit?: number;
+        offset?: number;
+    }): Promise<Task[]>;
+    /**
+     * Retrieves a specific task by its name.
+     * @param name The name of the task to retrieve
+     * @returns Promise resolving to the Task object if found, null otherwise
+     */
+    abstract getTasksByName(name: string): Promise<Task[]>;
+    abstract createTasks(tasks: Task[]): Promise<UUID[]>;
+    abstract getTasksByIds(taskIds: UUID[]): Promise<Task[]>;
+    abstract updateTasks(updates: Array<{
+        id: UUID;
+        task: Partial<Task>;
+    }>): Promise<void>;
+    abstract deleteTasks(taskIds: UUID[]): Promise<void>;
+    abstract getMemoriesByWorldId(params: {
+        worldIds?: UUID[];
+        /** @deprecated use limit */
+        count?: number;
+        limit?: number;
+        tableName?: string;
+    }): Promise<Memory[]>;
+    abstract getPairingRequests(queries: Array<{
+        channel: PairingChannel;
+        agentId: UUID;
+    }>): Promise<import("./types").PairingRequestsResult>;
+    abstract getPairingAllowlists(queries: Array<{
+        channel: PairingChannel;
+        agentId: UUID;
+    }>): Promise<import("./types").PairingAllowlistsResult>;
+    abstract createPairingRequests(requests: PairingRequest[]): Promise<UUID[]>;
+    abstract updatePairingRequests(requests: PairingRequest[]): Promise<void>;
+    abstract deletePairingRequests(ids: UUID[]): Promise<void>;
+    abstract createPairingAllowlistEntries(entries: PairingAllowlistEntry[]): Promise<UUID[]>;
+    abstract updatePairingAllowlistEntries(entries: PairingAllowlistEntry[]): Promise<void>;
+    abstract deletePairingAllowlistEntries(ids: UUID[]): Promise<void>;
+}
+//# sourceMappingURL=database.d.ts.map

package/dist/database.d.ts.map

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

package/dist/deterministic.d.ts

@@ -0,0 +1,31 @@
+import type { Memory, State } from "./types";
+import type { IAgentRuntime } from "./types/runtime";
+type SeedPart = string | number | boolean | null | undefined;
+export declare function buildDeterministicSeed(parts: readonly SeedPart[]): string;
+export declare function deterministicHex(seed: string, surface: string, length?: number): string;
+export declare function deterministicInt(seed: string, surface: string, maxExclusive: number): number;
+export declare function deterministicPickOne<T>(items: readonly T[], seed: string, surface: string): T | undefined;
+export declare function deterministicShuffle<T>(items: readonly T[], seed: string, surface?: string): T[];
+export declare function deterministicSample<T>(items: readonly T[], count: number, seed: string, surface?: string): T[];
+export declare function deterministicUuid(seed: string, surface: string): string;
+export declare function parseBooleanSetting(value: string | number | boolean | null): boolean;
+export declare function parsePositiveIntegerSetting(value: string | number | boolean | null, fallback: number): number;
+interface BuildConversationSeedOptions {
+    runtime: Pick<IAgentRuntime, "agentId" | "character">;
+    message?: Pick<Memory, "roomId" | "worldId">;
+    state?: Pick<State, "data">;
+    surface: string;
+    bucketMs?: number;
+    nowMs?: number;
+}
+export declare function buildConversationSeed({ runtime, message, state, surface, bucketMs, nowMs, }: BuildConversationSeedOptions): string;
+interface PromptReferenceDateOptions {
+    runtime: Pick<IAgentRuntime, "agentId" | "character" | "getSetting">;
+    message: Pick<Memory, "roomId">;
+    state: Pick<State, "data">;
+    surface: string;
+    nowMs?: number;
+}
+export declare function getPromptReferenceDate({ runtime, message, state, surface, nowMs, }: PromptReferenceDateOptions): Date;
+export {};
+//# sourceMappingURL=deterministic.d.ts.map

package/dist/deterministic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deterministic.d.ts","sourceRoot":"","sources":["../src/deterministic.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAC7C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAKrD,KAAK,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC;AA8B7D,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,SAAS,QAAQ,EAAE,GAAG,MAAM,CAEzE;AAED,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,MAAM,SAAK,GACV,MAAM,CAaR;AAED,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,GACnB,MAAM,CAeR;AAED,wBAAgB,oBAAoB,CAAC,CAAC,EACpC,KAAK,EAAE,SAAS,CAAC,EAAE,EACnB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GACd,CAAC,GAAG,SAAS,CAMf;AAED,wBAAgB,oBAAoB,CAAC,CAAC,EACpC,KAAK,EAAE,SAAS,CAAC,EAAE,EACnB,IAAI,EAAE,MAAM,EACZ,OAAO,SAAY,GAClB,CAAC,EAAE,CAOL;AAED,wBAAgB,mBAAmB,CAAC,CAAC,EACnC,KAAK,EAAE,SAAS,CAAC,EAAE,EACnB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,OAAO,SAAW,GACjB,CAAC,EAAE,CAML;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAGvE;AAED,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GACtC,OAAO,CAeT;AAED,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,EACvC,QAAQ,EAAE,MAAM,GACf,MAAM,CAaR;AAED,UAAU,4BAA4B;IACpC,OAAO,EAAE,IAAI,CAAC,aAAa,EAAE,SAAS,GAAG,WAAW,CAAC,CAAC;IACtD,OAAO,CAAC,EAAE,IAAI,CAAC,MAAM,EAAE,QAAQ,GAAG,SAAS,CAAC,CAAC;IAC7C,KAAK,CAAC,EAAE,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,qBAAqB,CAAC,EACpC,OAAO,EACP,OAAO,EACP,KAAK,EACL,OAAO,EACP,QAAQ,EACR,KAAkB,GACnB,EAAE,4BAA4B,GAAG,MAAM,CA4BvC;AAED,UAAU,0BAA0B;IAClC,OAAO,EAAE,IAAI,CAAC,aAAa,EAAE,SAAS,GAAG,WAAW,GAAG,YAAY,CAAC,CAAC;IACrE,OAAO,EAAE,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAChC,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,sBAAsB,CAAC,EACrC,OAAO,EACP,OAAO,EACP,KAAK,EACL,OAAO,EACP,KAAkB,GACnB,EAAE,0BAA0B,GAAG,IAAI,CA0BnC"}

package/dist/entities.d.ts

@@ -0,0 +1,11 @@
+import { type Entity, type IAgentRuntime, type Memory, type State, type UUID } from "./types";
+export declare function findEntityByName(runtime: IAgentRuntime, message: Memory, state: State): Promise<Entity | null>;
+export declare const createUniqueUuid: (runtime: IAgentRuntime, baseUserId: UUID | string) => UUID;
+export declare function getEntityDetails({ runtime, roomId, }: {
+    runtime: IAgentRuntime;
+    roomId: UUID;
+}): Promise<any[]>;
+export declare function formatEntities({ entities }: {
+    entities: Entity[];
+}): string;
+//# sourceMappingURL=entities.d.ts.map

package/dist/entities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entities.d.ts","sourceRoot":"","sources":["../src/entities.ts"],"names":[],"mappings":"AACA,OAAO,EACN,KAAK,MAAM,EACX,KAAK,aAAa,EAClB,KAAK,MAAM,EAGX,KAAK,KAAK,EACV,KAAK,IAAI,EAET,MAAM,SAAS,CAAC;AAyMjB,wBAAsB,gBAAgB,CACrC,OAAO,EAAE,aAAa,EACtB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,KAAK,GACV,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAgPxB;AAED,eAAO,MAAM,gBAAgB,GAC5B,SAAS,aAAa,EACtB,YAAY,IAAI,GAAG,MAAM,KACvB,IAOF,CAAC;AAEF,wBAAsB,gBAAgB,CAAC,EACtC,OAAO,EACP,MAAM,GACN,EAAE;IACF,OAAO,EAAE,aAAa,CAAC;IACvB,MAAM,EAAE,IAAI,CAAC;CACb,kBA2DA;AAED,wBAAgB,cAAc,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,UAMlE"}