@elizaos/core 2.0.0-alpha.7 → 2.0.0-alpha.71
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +213 -16
- package/dist/testing/index.js +22 -0
- package/dist/testing/index.js.map +9 -0
- package/package.json +46 -27
- package/dist/actions.d.ts +0 -22
- package/dist/actions.d.ts.map +0 -1
- package/dist/browser/index.browser.js +0 -771
- package/dist/browser/index.browser.js.map +0 -427
- package/dist/browser/index.d.ts +0 -2
- package/dist/character.d.ts +0 -39
- package/dist/character.d.ts.map +0 -1
- package/dist/constants/index.d.ts +0 -7
- package/dist/constants/secrets.d.ts +0 -67
- package/dist/database.d.ts +0 -494
- package/dist/database.d.ts.map +0 -1
- package/dist/elizaos.d.ts +0 -194
- package/dist/elizaos.d.ts.map +0 -1
- package/dist/entities.d.ts +0 -40
- package/dist/entities.d.ts.map +0 -1
- package/dist/index.browser.d.ts +0 -39
- package/dist/index.browser.d.ts.map +0 -1
- package/dist/index.d.ts +0 -40
- package/dist/index.d.ts.map +0 -1
- package/dist/index.js +0 -2
- package/dist/index.node.d.ts +0 -37
- package/dist/index.node.d.ts.map +0 -1
- package/dist/logger.d.ts +0 -72
- package/dist/logger.d.ts.map +0 -1
- package/dist/memory.d.ts +0 -63
- package/dist/memory.d.ts.map +0 -1
- package/dist/node/index.d.ts +0 -2
- package/dist/node/index.node.js +0 -53403
- package/dist/node/index.node.js.map +0 -511
- package/dist/onboarding-state.d.ts +0 -209
- package/dist/plugin.d.ts +0 -55
- package/dist/plugin.d.ts.map +0 -1
- package/dist/prompts.d.ts +0 -7
- package/dist/prompts.d.ts.map +0 -1
- package/dist/request-context.d.ts +0 -142
- package/dist/request-context.d.ts.map +0 -1
- package/dist/request-context.node.d.ts +0 -36
- package/dist/request-context.node.d.ts.map +0 -1
- package/dist/roles.d.ts +0 -23
- package/dist/roles.d.ts.map +0 -1
- package/dist/runtime.d.ts +0 -366
- package/dist/runtime.d.ts.map +0 -1
- package/dist/schemas/character.d.ts +0 -151
- package/dist/schemas/character.d.ts.map +0 -1
- package/dist/search.d.ts +0 -316
- package/dist/search.d.ts.map +0 -1
- package/dist/secrets.d.ts +0 -11
- package/dist/secrets.d.ts.map +0 -1
- package/dist/services/default-message-service.d.ts +0 -69
- package/dist/services/default-message-service.d.ts.map +0 -1
- package/dist/services/message-service.d.ts +0 -171
- package/dist/services/message-service.d.ts.map +0 -1
- package/dist/services.d.ts +0 -56
- package/dist/services.d.ts.map +0 -1
- package/dist/sessions/index.d.ts +0 -10
- package/dist/sessions/paths.d.ts +0 -56
- package/dist/sessions/provider.d.ts +0 -73
- package/dist/sessions/session-key.d.ts +0 -133
- package/dist/sessions/store.d.ts +0 -75
- package/dist/sessions/types.d.ts +0 -195
- package/dist/settings.d.ts +0 -90
- package/dist/settings.d.ts.map +0 -1
- package/dist/streaming-context.browser.d.ts +0 -26
- package/dist/streaming-context.browser.d.ts.map +0 -1
- package/dist/streaming-context.d.ts +0 -95
- package/dist/streaming-context.d.ts.map +0 -1
- package/dist/streaming-context.node.d.ts +0 -15
- package/dist/streaming-context.node.d.ts.map +0 -1
- package/dist/types/agent.d.ts +0 -97
- package/dist/types/agent.d.ts.map +0 -1
- package/dist/types/components.d.ts +0 -155
- package/dist/types/components.d.ts.map +0 -1
- package/dist/types/database.d.ts +0 -414
- package/dist/types/database.d.ts.map +0 -1
- package/dist/types/elizaos.d.ts +0 -159
- package/dist/types/elizaos.d.ts.map +0 -1
- package/dist/types/environment.d.ts +0 -116
- package/dist/types/environment.d.ts.map +0 -1
- package/dist/types/events.d.ts +0 -203
- package/dist/types/events.d.ts.map +0 -1
- package/dist/types/index.d.ts +0 -20
- package/dist/types/index.d.ts.map +0 -1
- package/dist/types/knowledge.d.ts +0 -30
- package/dist/types/knowledge.d.ts.map +0 -1
- package/dist/types/memory.d.ts +0 -102
- package/dist/types/memory.d.ts.map +0 -1
- package/dist/types/messaging.d.ts +0 -137
- package/dist/types/messaging.d.ts.map +0 -1
- package/dist/types/model.d.ts +0 -513
- package/dist/types/model.d.ts.map +0 -1
- package/dist/types/plugin.d.ts +0 -91
- package/dist/types/plugin.d.ts.map +0 -1
- package/dist/types/primitives.d.ts +0 -96
- package/dist/types/primitives.d.ts.map +0 -1
- package/dist/types/runtime.d.ts +0 -140
- package/dist/types/runtime.d.ts.map +0 -1
- package/dist/types/service.d.ts +0 -150
- package/dist/types/service.d.ts.map +0 -1
- package/dist/types/settings.d.ts +0 -29
- package/dist/types/settings.d.ts.map +0 -1
- package/dist/types/state.d.ts +0 -56
- package/dist/types/state.d.ts.map +0 -1
- package/dist/types/streaming.d.ts +0 -71
- package/dist/types/streaming.d.ts.map +0 -1
- package/dist/types/task.d.ts +0 -67
- package/dist/types/task.d.ts.map +0 -1
- package/dist/types/tee.d.ts +0 -96
- package/dist/types/tee.d.ts.map +0 -1
- package/dist/types/testing.d.ts +0 -28
- package/dist/types/testing.d.ts.map +0 -1
- package/dist/utils/buffer.d.ts +0 -104
- package/dist/utils/buffer.d.ts.map +0 -1
- package/dist/utils/crypto-compat.d.ts +0 -183
- package/dist/utils/crypto-compat.d.ts.map +0 -1
- package/dist/utils/environment.d.ts +0 -50
- package/dist/utils/environment.d.ts.map +0 -1
- package/dist/utils/node.d.ts +0 -5
- package/dist/utils/node.d.ts.map +0 -1
- package/dist/utils/paths.d.ts +0 -92
- package/dist/utils/paths.d.ts.map +0 -1
- package/dist/utils/server-health.d.ts +0 -22
- package/dist/utils/server-health.d.ts.map +0 -1
- package/dist/utils/streaming.d.ts +0 -179
- package/dist/utils/streaming.d.ts.map +0 -1
- package/dist/utils/type-guards.d.ts +0 -23
- package/dist/utils/type-guards.d.ts.map +0 -1
- package/dist/utils.d.ts +0 -182
- package/dist/utils.d.ts.map +0 -1
package/dist/types/database.d.ts
DELETED
|
@@ -1,414 +0,0 @@
|
|
|
1
|
-
import type { Agent } from './agent';
|
|
2
|
-
import type { Component, Entity, Participant, Relationship, Room, World } from './environment';
|
|
3
|
-
import type { Memory, MemoryMetadata } from './memory';
|
|
4
|
-
import type { Metadata, UUID } from './primitives';
|
|
5
|
-
import type { Task } from './task';
|
|
6
|
-
/**
|
|
7
|
-
* Base log body type with common properties
|
|
8
|
-
*/
|
|
9
|
-
export interface BaseLogBody {
|
|
10
|
-
runId?: string | UUID;
|
|
11
|
-
status?: string;
|
|
12
|
-
messageId?: UUID;
|
|
13
|
-
roomId?: UUID;
|
|
14
|
-
entityId?: UUID;
|
|
15
|
-
metadata?: Record<string, unknown>;
|
|
16
|
-
[key: string]: unknown;
|
|
17
|
-
}
|
|
18
|
-
/**
|
|
19
|
-
* Log body for action logs
|
|
20
|
-
*/
|
|
21
|
-
export interface ActionLogBody extends BaseLogBody {
|
|
22
|
-
action?: string;
|
|
23
|
-
actionId?: UUID | string;
|
|
24
|
-
message?: string;
|
|
25
|
-
messageId?: UUID;
|
|
26
|
-
state?: unknown;
|
|
27
|
-
responses?: unknown;
|
|
28
|
-
content?: {
|
|
29
|
-
actions?: string[];
|
|
30
|
-
[key: string]: unknown;
|
|
31
|
-
};
|
|
32
|
-
result?: {
|
|
33
|
-
success?: boolean;
|
|
34
|
-
data?: unknown;
|
|
35
|
-
text?: string;
|
|
36
|
-
error?: string | Error;
|
|
37
|
-
[key: string]: unknown;
|
|
38
|
-
};
|
|
39
|
-
isLegacyReturn?: boolean;
|
|
40
|
-
prompts?: Array<{
|
|
41
|
-
modelType: string;
|
|
42
|
-
prompt: string;
|
|
43
|
-
timestamp: number;
|
|
44
|
-
}>;
|
|
45
|
-
promptCount?: number;
|
|
46
|
-
planStep?: string;
|
|
47
|
-
planThought?: string;
|
|
48
|
-
}
|
|
49
|
-
/**
|
|
50
|
-
* Log body for evaluator logs
|
|
51
|
-
*/
|
|
52
|
-
export interface EvaluatorLogBody extends BaseLogBody {
|
|
53
|
-
evaluator?: string;
|
|
54
|
-
messageId?: UUID;
|
|
55
|
-
message?: string;
|
|
56
|
-
state?: unknown;
|
|
57
|
-
}
|
|
58
|
-
/**
|
|
59
|
-
* Log body for model logs
|
|
60
|
-
*/
|
|
61
|
-
export interface ModelLogBody extends BaseLogBody {
|
|
62
|
-
modelType?: string;
|
|
63
|
-
modelKey?: string;
|
|
64
|
-
params?: Record<string, unknown>;
|
|
65
|
-
prompt?: string;
|
|
66
|
-
systemPrompt?: string | null;
|
|
67
|
-
timestamp?: number;
|
|
68
|
-
executionTime?: number;
|
|
69
|
-
provider?: string;
|
|
70
|
-
actionContext?: {
|
|
71
|
-
actionName: string;
|
|
72
|
-
actionId: UUID;
|
|
73
|
-
};
|
|
74
|
-
response?: unknown;
|
|
75
|
-
}
|
|
76
|
-
/**
|
|
77
|
-
* Log body for embedding logs
|
|
78
|
-
*/
|
|
79
|
-
export interface EmbeddingLogBody extends BaseLogBody {
|
|
80
|
-
status?: string;
|
|
81
|
-
memoryId?: string;
|
|
82
|
-
duration?: number;
|
|
83
|
-
}
|
|
84
|
-
/**
|
|
85
|
-
* Union type for all possible log body types
|
|
86
|
-
*/
|
|
87
|
-
export type LogBody = BaseLogBody | ActionLogBody | EvaluatorLogBody | ModelLogBody | EmbeddingLogBody;
|
|
88
|
-
/**
|
|
89
|
-
* Represents a log entry
|
|
90
|
-
*/
|
|
91
|
-
export interface Log {
|
|
92
|
-
/** Optional unique identifier */
|
|
93
|
-
id?: UUID;
|
|
94
|
-
/** Associated entity ID */
|
|
95
|
-
entityId: UUID;
|
|
96
|
-
/** Associated room ID */
|
|
97
|
-
roomId?: UUID;
|
|
98
|
-
/** Log body - can be any of the log body types */
|
|
99
|
-
body: LogBody;
|
|
100
|
-
/** Log type */
|
|
101
|
-
type: string;
|
|
102
|
-
/** Log creation timestamp */
|
|
103
|
-
createdAt: Date;
|
|
104
|
-
}
|
|
105
|
-
export type RunStatus = 'started' | 'completed' | 'timeout' | 'error';
|
|
106
|
-
export interface AgentRunCounts {
|
|
107
|
-
actions: number;
|
|
108
|
-
modelCalls: number;
|
|
109
|
-
errors: number;
|
|
110
|
-
evaluators: number;
|
|
111
|
-
}
|
|
112
|
-
export interface AgentRunSummary {
|
|
113
|
-
runId: string;
|
|
114
|
-
status: RunStatus;
|
|
115
|
-
startedAt: number | null;
|
|
116
|
-
endedAt: number | null;
|
|
117
|
-
durationMs: number | null;
|
|
118
|
-
messageId?: UUID;
|
|
119
|
-
roomId?: UUID;
|
|
120
|
-
entityId?: UUID;
|
|
121
|
-
metadata?: Record<string, unknown>;
|
|
122
|
-
counts?: AgentRunCounts;
|
|
123
|
-
}
|
|
124
|
-
export interface AgentRunSummaryResult {
|
|
125
|
-
runs: AgentRunSummary[];
|
|
126
|
-
total: number;
|
|
127
|
-
hasMore: boolean;
|
|
128
|
-
}
|
|
129
|
-
/**
|
|
130
|
-
* Interface for database operations
|
|
131
|
-
*/
|
|
132
|
-
export interface IDatabaseAdapter {
|
|
133
|
-
/** Database instance */
|
|
134
|
-
db: unknown;
|
|
135
|
-
/** Initialize database connection */
|
|
136
|
-
initialize(config?: Record<string, string | number | boolean | null>): Promise<void>;
|
|
137
|
-
/** Initialize database connection */
|
|
138
|
-
init(): Promise<void>;
|
|
139
|
-
/**
|
|
140
|
-
* Run plugin schema migrations for all registered plugins
|
|
141
|
-
* @param plugins Array of plugins with their schemas
|
|
142
|
-
* @param options Migration options (verbose, force, dryRun, etc.)
|
|
143
|
-
*/
|
|
144
|
-
runPluginMigrations?(plugins: Array<{
|
|
145
|
-
name: string;
|
|
146
|
-
schema?: Record<string, string | number | boolean | null | Record<string, unknown>>;
|
|
147
|
-
}>, options?: {
|
|
148
|
-
verbose?: boolean;
|
|
149
|
-
force?: boolean;
|
|
150
|
-
dryRun?: boolean;
|
|
151
|
-
}): Promise<void>;
|
|
152
|
-
/**
|
|
153
|
-
* Run database migrations from migration files
|
|
154
|
-
* @param migrationsPaths Optional array of migration file paths
|
|
155
|
-
*/
|
|
156
|
-
runMigrations?(migrationsPaths?: string[]): Promise<void>;
|
|
157
|
-
/** Check if the database connection is ready */
|
|
158
|
-
isReady(): Promise<boolean>;
|
|
159
|
-
/** Close database connection */
|
|
160
|
-
close(): Promise<void>;
|
|
161
|
-
getConnection(): Promise<unknown>;
|
|
162
|
-
/**
|
|
163
|
-
* Execute a callback with entity context for Entity RLS
|
|
164
|
-
* @param entityId - The entity ID to set as context
|
|
165
|
-
* @param callback - The callback to execute within the entity context
|
|
166
|
-
* @returns The result of the callback
|
|
167
|
-
*/
|
|
168
|
-
withEntityContext?<T>(entityId: UUID | null, callback: () => Promise<T>): Promise<T>;
|
|
169
|
-
getAgent(agentId: UUID): Promise<Agent | null>;
|
|
170
|
-
/** Get all agents */
|
|
171
|
-
getAgents(): Promise<Partial<Agent>[]>;
|
|
172
|
-
createAgent(agent: Partial<Agent>): Promise<boolean>;
|
|
173
|
-
updateAgent(agentId: UUID, agent: Partial<Agent>): Promise<boolean>;
|
|
174
|
-
deleteAgent(agentId: UUID): Promise<boolean>;
|
|
175
|
-
ensureEmbeddingDimension(dimension: number): Promise<void>;
|
|
176
|
-
/** Get entity by IDs */
|
|
177
|
-
getEntitiesByIds(entityIds: UUID[]): Promise<Entity[] | null>;
|
|
178
|
-
/** Get entities for room */
|
|
179
|
-
getEntitiesForRoom(roomId: UUID, includeComponents?: boolean): Promise<Entity[]>;
|
|
180
|
-
/** Create new entities */
|
|
181
|
-
createEntities(entities: Entity[]): Promise<boolean>;
|
|
182
|
-
/** Update entity */
|
|
183
|
-
updateEntity(entity: Entity): Promise<void>;
|
|
184
|
-
/** Get component by ID */
|
|
185
|
-
getComponent(entityId: UUID, type: string, worldId?: UUID, sourceEntityId?: UUID): Promise<Component | null>;
|
|
186
|
-
/** Get all components for an entity */
|
|
187
|
-
getComponents(entityId: UUID, worldId?: UUID, sourceEntityId?: UUID): Promise<Component[]>;
|
|
188
|
-
/** Create component */
|
|
189
|
-
createComponent(component: Component): Promise<boolean>;
|
|
190
|
-
/** Update component */
|
|
191
|
-
updateComponent(component: Component): Promise<void>;
|
|
192
|
-
/** Delete component */
|
|
193
|
-
deleteComponent(componentId: UUID): Promise<void>;
|
|
194
|
-
/** Get memories matching criteria */
|
|
195
|
-
getMemories(params: {
|
|
196
|
-
entityId?: UUID;
|
|
197
|
-
agentId?: UUID;
|
|
198
|
-
count?: number;
|
|
199
|
-
offset?: number;
|
|
200
|
-
unique?: boolean;
|
|
201
|
-
tableName: string;
|
|
202
|
-
start?: number;
|
|
203
|
-
end?: number;
|
|
204
|
-
roomId?: UUID;
|
|
205
|
-
worldId?: UUID;
|
|
206
|
-
}): Promise<Memory[]>;
|
|
207
|
-
getMemoryById(id: UUID): Promise<Memory | null>;
|
|
208
|
-
getMemoriesByIds(ids: UUID[], tableName?: string): Promise<Memory[]>;
|
|
209
|
-
getMemoriesByRoomIds(params: {
|
|
210
|
-
tableName: string;
|
|
211
|
-
roomIds: UUID[];
|
|
212
|
-
limit?: number;
|
|
213
|
-
}): Promise<Memory[]>;
|
|
214
|
-
getCachedEmbeddings(params: {
|
|
215
|
-
query_table_name: string;
|
|
216
|
-
query_threshold: number;
|
|
217
|
-
query_input: string;
|
|
218
|
-
query_field_name: string;
|
|
219
|
-
query_field_sub_name: string;
|
|
220
|
-
query_match_count: number;
|
|
221
|
-
}): Promise<{
|
|
222
|
-
embedding: number[];
|
|
223
|
-
levenshtein_score: number;
|
|
224
|
-
}[]>;
|
|
225
|
-
log(params: {
|
|
226
|
-
body: {
|
|
227
|
-
[key: string]: unknown;
|
|
228
|
-
};
|
|
229
|
-
entityId: UUID;
|
|
230
|
-
roomId: UUID;
|
|
231
|
-
type: string;
|
|
232
|
-
}): Promise<void>;
|
|
233
|
-
getLogs(params: {
|
|
234
|
-
entityId?: UUID;
|
|
235
|
-
roomId?: UUID;
|
|
236
|
-
type?: string;
|
|
237
|
-
count?: number;
|
|
238
|
-
offset?: number;
|
|
239
|
-
}): Promise<Log[]>;
|
|
240
|
-
deleteLog(logId: UUID): Promise<void>;
|
|
241
|
-
getAgentRunSummaries?(params: {
|
|
242
|
-
limit?: number;
|
|
243
|
-
roomId?: UUID;
|
|
244
|
-
status?: RunStatus | 'all';
|
|
245
|
-
from?: number;
|
|
246
|
-
to?: number;
|
|
247
|
-
entityId?: UUID;
|
|
248
|
-
}): Promise<AgentRunSummaryResult>;
|
|
249
|
-
searchMemories(params: {
|
|
250
|
-
embedding: number[];
|
|
251
|
-
match_threshold?: number;
|
|
252
|
-
count?: number;
|
|
253
|
-
unique?: boolean;
|
|
254
|
-
tableName: string;
|
|
255
|
-
query?: string;
|
|
256
|
-
roomId?: UUID;
|
|
257
|
-
worldId?: UUID;
|
|
258
|
-
entityId?: UUID;
|
|
259
|
-
}): Promise<Memory[]>;
|
|
260
|
-
createMemory(memory: Memory, tableName: string, unique?: boolean): Promise<UUID>;
|
|
261
|
-
updateMemory(memory: Partial<Memory> & {
|
|
262
|
-
id: UUID;
|
|
263
|
-
metadata?: MemoryMetadata;
|
|
264
|
-
}): Promise<boolean>;
|
|
265
|
-
deleteMemory(memoryId: UUID): Promise<void>;
|
|
266
|
-
deleteManyMemories(memoryIds: UUID[]): Promise<void>;
|
|
267
|
-
deleteAllMemories(roomId: UUID, tableName: string): Promise<void>;
|
|
268
|
-
countMemories(roomId: UUID, unique?: boolean, tableName?: string): Promise<number>;
|
|
269
|
-
createWorld(world: World): Promise<UUID>;
|
|
270
|
-
getWorld(id: UUID): Promise<World | null>;
|
|
271
|
-
removeWorld(id: UUID): Promise<void>;
|
|
272
|
-
getAllWorlds(): Promise<World[]>;
|
|
273
|
-
updateWorld(world: World): Promise<void>;
|
|
274
|
-
getRoomsByIds(roomIds: UUID[]): Promise<Room[] | null>;
|
|
275
|
-
createRooms(rooms: Room[]): Promise<UUID[]>;
|
|
276
|
-
deleteRoom(roomId: UUID): Promise<void>;
|
|
277
|
-
deleteRoomsByWorldId(worldId: UUID): Promise<void>;
|
|
278
|
-
updateRoom(room: Room): Promise<void>;
|
|
279
|
-
getRoomsForParticipant(entityId: UUID): Promise<UUID[]>;
|
|
280
|
-
getRoomsForParticipants(userIds: UUID[]): Promise<UUID[]>;
|
|
281
|
-
getRoomsByWorld(worldId: UUID): Promise<Room[]>;
|
|
282
|
-
removeParticipant(entityId: UUID, roomId: UUID): Promise<boolean>;
|
|
283
|
-
getParticipantsForEntity(entityId: UUID): Promise<Participant[]>;
|
|
284
|
-
getParticipantsForRoom(roomId: UUID): Promise<UUID[]>;
|
|
285
|
-
isRoomParticipant(roomId: UUID, entityId: UUID): Promise<boolean>;
|
|
286
|
-
addParticipantsRoom(entityIds: UUID[], roomId: UUID): Promise<boolean>;
|
|
287
|
-
getParticipantUserState(roomId: UUID, entityId: UUID): Promise<'FOLLOWED' | 'MUTED' | null>;
|
|
288
|
-
setParticipantUserState(roomId: UUID, entityId: UUID, state: 'FOLLOWED' | 'MUTED' | null): Promise<void>;
|
|
289
|
-
/**
|
|
290
|
-
* Creates a new relationship between two entities.
|
|
291
|
-
* @param params Object containing the relationship details
|
|
292
|
-
* @returns Promise resolving to boolean indicating success
|
|
293
|
-
*/
|
|
294
|
-
createRelationship(params: {
|
|
295
|
-
sourceEntityId: UUID;
|
|
296
|
-
targetEntityId: UUID;
|
|
297
|
-
tags?: string[];
|
|
298
|
-
metadata?: Metadata;
|
|
299
|
-
}): Promise<boolean>;
|
|
300
|
-
/**
|
|
301
|
-
* Updates an existing relationship between two entities.
|
|
302
|
-
* @param relationship The relationship object with updated data
|
|
303
|
-
* @returns Promise resolving to void
|
|
304
|
-
*/
|
|
305
|
-
updateRelationship(relationship: Relationship): Promise<void>;
|
|
306
|
-
/**
|
|
307
|
-
* Retrieves a relationship between two entities if it exists.
|
|
308
|
-
* @param params Object containing the entity IDs and agent ID
|
|
309
|
-
* @returns Promise resolving to the Relationship object or null if not found
|
|
310
|
-
*/
|
|
311
|
-
getRelationship(params: {
|
|
312
|
-
sourceEntityId: UUID;
|
|
313
|
-
targetEntityId: UUID;
|
|
314
|
-
}): Promise<Relationship | null>;
|
|
315
|
-
/**
|
|
316
|
-
* Retrieves all relationships for a specific entity.
|
|
317
|
-
* @param params Object containing the user ID, agent ID and optional tags to filter by
|
|
318
|
-
* @returns Promise resolving to an array of Relationship objects
|
|
319
|
-
*/
|
|
320
|
-
getRelationships(params: {
|
|
321
|
-
entityId: UUID;
|
|
322
|
-
tags?: string[];
|
|
323
|
-
}): Promise<Relationship[]>;
|
|
324
|
-
getCache<T>(key: string): Promise<T | undefined>;
|
|
325
|
-
setCache<T>(key: string, value: T): Promise<boolean>;
|
|
326
|
-
deleteCache(key: string): Promise<boolean>;
|
|
327
|
-
createTask(task: Task): Promise<UUID>;
|
|
328
|
-
getTasks(params: {
|
|
329
|
-
roomId?: UUID;
|
|
330
|
-
tags?: string[];
|
|
331
|
-
entityId?: UUID;
|
|
332
|
-
}): Promise<Task[]>;
|
|
333
|
-
getTask(id: UUID): Promise<Task | null>;
|
|
334
|
-
getTasksByName(name: string): Promise<Task[]>;
|
|
335
|
-
updateTask(id: UUID, task: Partial<Task>): Promise<void>;
|
|
336
|
-
deleteTask(id: UUID): Promise<void>;
|
|
337
|
-
getMemoriesByWorldId(params: {
|
|
338
|
-
worldId: UUID;
|
|
339
|
-
count?: number;
|
|
340
|
-
tableName?: string;
|
|
341
|
-
}): Promise<Memory[]>;
|
|
342
|
-
}
|
|
343
|
-
/**
|
|
344
|
-
* Result interface for embedding similarity searches
|
|
345
|
-
*/
|
|
346
|
-
export interface EmbeddingSearchResult {
|
|
347
|
-
embedding: number[];
|
|
348
|
-
levenshtein_score: number;
|
|
349
|
-
}
|
|
350
|
-
/**
|
|
351
|
-
* Options for memory retrieval operations
|
|
352
|
-
*/
|
|
353
|
-
export interface MemoryRetrievalOptions {
|
|
354
|
-
roomId: UUID;
|
|
355
|
-
count?: number;
|
|
356
|
-
unique?: boolean;
|
|
357
|
-
start?: number;
|
|
358
|
-
end?: number;
|
|
359
|
-
agentId?: UUID;
|
|
360
|
-
}
|
|
361
|
-
/**
|
|
362
|
-
* Options for memory search operations
|
|
363
|
-
*/
|
|
364
|
-
export interface MemorySearchOptions {
|
|
365
|
-
embedding: number[];
|
|
366
|
-
match_threshold?: number;
|
|
367
|
-
count?: number;
|
|
368
|
-
roomId: UUID;
|
|
369
|
-
agentId?: UUID;
|
|
370
|
-
unique?: boolean;
|
|
371
|
-
metadata?: Partial<MemoryMetadata>;
|
|
372
|
-
}
|
|
373
|
-
/**
|
|
374
|
-
* Options for multi-room memory retrieval
|
|
375
|
-
*/
|
|
376
|
-
export interface MultiRoomMemoryOptions {
|
|
377
|
-
roomIds: UUID[];
|
|
378
|
-
limit?: number;
|
|
379
|
-
agentId?: UUID;
|
|
380
|
-
}
|
|
381
|
-
/**
|
|
382
|
-
* Unified options pattern for memory operations
|
|
383
|
-
* Provides a simpler, more consistent interface
|
|
384
|
-
*/
|
|
385
|
-
export interface UnifiedMemoryOptions {
|
|
386
|
-
roomId: UUID;
|
|
387
|
-
limit?: number;
|
|
388
|
-
agentId?: UUID;
|
|
389
|
-
unique?: boolean;
|
|
390
|
-
start?: number;
|
|
391
|
-
end?: number;
|
|
392
|
-
}
|
|
393
|
-
/**
|
|
394
|
-
* Specialized memory search options
|
|
395
|
-
*/
|
|
396
|
-
export interface UnifiedSearchOptions extends UnifiedMemoryOptions {
|
|
397
|
-
embedding: number[];
|
|
398
|
-
similarity?: number;
|
|
399
|
-
}
|
|
400
|
-
/**
|
|
401
|
-
* Represents a generic database connection object.
|
|
402
|
-
* The actual type of this connection will depend on the specific database adapter implementation
|
|
403
|
-
* (e.g., a connection pool object for PostgreSQL, a client instance for a NoSQL database).
|
|
404
|
-
* This `unknown` type serves as a placeholder in the abstract `IDatabaseAdapter`.
|
|
405
|
-
*/
|
|
406
|
-
export type DbConnection = unknown;
|
|
407
|
-
export declare const VECTOR_DIMS: {
|
|
408
|
-
readonly SMALL: 384;
|
|
409
|
-
readonly MEDIUM: 512;
|
|
410
|
-
readonly LARGE: 768;
|
|
411
|
-
readonly XL: 1024;
|
|
412
|
-
readonly XXL: 1536;
|
|
413
|
-
readonly XXXL: 3072;
|
|
414
|
-
};
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"database.d.ts","sourceRoot":"","sources":["../../src/types/database.ts"],"names":[],"mappings":"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"}
|
package/dist/types/elizaos.d.ts
DELETED
|
@@ -1,159 +0,0 @@
|
|
|
1
|
-
import type { UUID, Content } from './primitives';
|
|
2
|
-
import type { Memory } from './memory';
|
|
3
|
-
import type { IAgentRuntime } from './runtime';
|
|
4
|
-
import type { Character } from './agent';
|
|
5
|
-
import type { State } from './state';
|
|
6
|
-
import type { MessageProcessingOptions, MessageProcessingResult } from '../services/message-service';
|
|
7
|
-
/**
|
|
8
|
-
* Batch operation for sending messages
|
|
9
|
-
*/
|
|
10
|
-
export interface BatchOperation {
|
|
11
|
-
agentId: UUID;
|
|
12
|
-
operation: 'message' | 'action' | 'evaluate';
|
|
13
|
-
payload: any;
|
|
14
|
-
}
|
|
15
|
-
/**
|
|
16
|
-
* Result of a batch operation
|
|
17
|
-
*/
|
|
18
|
-
export interface BatchResult {
|
|
19
|
-
agentId: UUID;
|
|
20
|
-
success: boolean;
|
|
21
|
-
result?: any;
|
|
22
|
-
error?: Error;
|
|
23
|
-
}
|
|
24
|
-
/**
|
|
25
|
-
* Read-only runtime accessor
|
|
26
|
-
*/
|
|
27
|
-
export interface ReadonlyRuntime {
|
|
28
|
-
getAgent(id: UUID): IAgentRuntime | undefined;
|
|
29
|
-
getAgents(): IAgentRuntime[];
|
|
30
|
-
getState(agentId: UUID): State | undefined;
|
|
31
|
-
}
|
|
32
|
-
/**
|
|
33
|
-
* Health status for an agent
|
|
34
|
-
*/
|
|
35
|
-
export interface HealthStatus {
|
|
36
|
-
alive: boolean;
|
|
37
|
-
responsive: boolean;
|
|
38
|
-
memoryUsage?: number;
|
|
39
|
-
uptime?: number;
|
|
40
|
-
}
|
|
41
|
-
/**
|
|
42
|
-
* Update operation for an agent
|
|
43
|
-
*/
|
|
44
|
-
export interface AgentUpdate {
|
|
45
|
-
id: UUID;
|
|
46
|
-
character: Partial<Character>;
|
|
47
|
-
}
|
|
48
|
-
/**
|
|
49
|
-
* Options for handling a message to an agent.
|
|
50
|
-
* Extends MessageProcessingOptions with orchestration callbacks for async mode.
|
|
51
|
-
*/
|
|
52
|
-
export interface HandleMessageOptions extends MessageProcessingOptions {
|
|
53
|
-
/**
|
|
54
|
-
* Called when the agent generates a response (ASYNC MODE)
|
|
55
|
-
* If provided, method returns immediately (fire & forget)
|
|
56
|
-
* If not provided, method waits for response (SYNC MODE)
|
|
57
|
-
*
|
|
58
|
-
* @param content - The response content from the agent
|
|
59
|
-
*/
|
|
60
|
-
onResponse?: (content: Content) => Promise<void>;
|
|
61
|
-
/**
|
|
62
|
-
* Called if an error occurs during processing
|
|
63
|
-
*/
|
|
64
|
-
onError?: (error: Error) => Promise<void>;
|
|
65
|
-
/**
|
|
66
|
-
* Called when processing is complete
|
|
67
|
-
*/
|
|
68
|
-
onComplete?: () => Promise<void>;
|
|
69
|
-
}
|
|
70
|
-
/**
|
|
71
|
-
* Result of handling a message to an agent
|
|
72
|
-
*/
|
|
73
|
-
export interface HandleMessageResult {
|
|
74
|
-
/** ID of the user message */
|
|
75
|
-
messageId: UUID;
|
|
76
|
-
/** The user message that was created */
|
|
77
|
-
userMessage: Memory;
|
|
78
|
-
/**
|
|
79
|
-
* Processing result (only in SYNC mode)
|
|
80
|
-
* Contains information about message processing success and agent responses
|
|
81
|
-
* Access via result.processing instead of result.result for clarity
|
|
82
|
-
*/
|
|
83
|
-
processing?: MessageProcessingResult;
|
|
84
|
-
}
|
|
85
|
-
/**
|
|
86
|
-
* Interface for the ElizaOS orchestrator
|
|
87
|
-
* Provides unified messaging API across all platforms
|
|
88
|
-
*/
|
|
89
|
-
export interface IElizaOS {
|
|
90
|
-
/**
|
|
91
|
-
* Send a message to an agent using the unified messaging API.
|
|
92
|
-
*
|
|
93
|
-
* This method provides a standardized entry point for message processing with two modes:
|
|
94
|
-
*
|
|
95
|
-
* **SYNC MODE (default)**: Waits for agent response before returning
|
|
96
|
-
* - Returns the complete processing result including agent responses
|
|
97
|
-
* - Useful when you need to immediately act on the agent's reply
|
|
98
|
-
* - Usage: Don't provide `onResponse` callback in options
|
|
99
|
-
*
|
|
100
|
-
* **ASYNC MODE**: Returns immediately, calls back when agent responds
|
|
101
|
-
* - Non-blocking, suitable for high-throughput scenarios
|
|
102
|
-
* - Provides callbacks for response, errors, and completion
|
|
103
|
-
* - Usage: Provide `onResponse` callback in options
|
|
104
|
-
*
|
|
105
|
-
* Features:
|
|
106
|
-
* - Auto-fills missing fields (id, agentId, createdAt)
|
|
107
|
-
* - Ensures connections exist before processing
|
|
108
|
-
* - Handles entity context (RLS) if available
|
|
109
|
-
* - Supports retries and timeouts
|
|
110
|
-
*
|
|
111
|
-
* @param agentId - The ID of the agent to send the message to
|
|
112
|
-
* @param message - The message to send (partial Memory with required fields: entityId, roomId, content)
|
|
113
|
-
* @param options - Optional processing options (callbacks, retries, timeouts, etc.)
|
|
114
|
-
* @returns Promise with message result (includes agent responses in SYNC mode)
|
|
115
|
-
*
|
|
116
|
-
* @example
|
|
117
|
-
* // SYNC mode - wait for response
|
|
118
|
-
* const result = await elizaOS.handleMessage(agentId, {
|
|
119
|
-
* entityId: userId,
|
|
120
|
-
* roomId: channelId,
|
|
121
|
-
* content: { text: "Hello!" }
|
|
122
|
-
* });
|
|
123
|
-
* console.log(result.processing?.responseContent); // Agent's response
|
|
124
|
-
*
|
|
125
|
-
* @example
|
|
126
|
-
* // ASYNC mode - fire and forget
|
|
127
|
-
* await elizaOS.handleMessage(agentId, message, {
|
|
128
|
-
* onResponse: async (content) => {
|
|
129
|
-
* console.log("Agent replied:", content.text);
|
|
130
|
-
* },
|
|
131
|
-
* onError: async (error) => {
|
|
132
|
-
* console.error("Processing failed:", error);
|
|
133
|
-
* }
|
|
134
|
-
* });
|
|
135
|
-
*/
|
|
136
|
-
handleMessage(agentId: UUID, message: Partial<Memory> & {
|
|
137
|
-
entityId: UUID;
|
|
138
|
-
roomId: UUID;
|
|
139
|
-
content: Content;
|
|
140
|
-
worldId?: UUID;
|
|
141
|
-
}, options?: HandleMessageOptions): Promise<HandleMessageResult>;
|
|
142
|
-
/**
|
|
143
|
-
* Get an agent runtime by ID.
|
|
144
|
-
*
|
|
145
|
-
* Use this to access the runtime instance of a registered agent,
|
|
146
|
-
* allowing direct interaction with agent services, state, and methods.
|
|
147
|
-
*
|
|
148
|
-
* @param agentId - The UUID of the agent
|
|
149
|
-
* @returns The agent runtime instance or undefined if agent not found
|
|
150
|
-
*
|
|
151
|
-
* @example
|
|
152
|
-
* const runtime = elizaOS.getAgent(agentId);
|
|
153
|
-
* if (runtime) {
|
|
154
|
-
* console.log("Agent character:", runtime.character.name);
|
|
155
|
-
* await runtime.messageService.handleMessage(...);
|
|
156
|
-
* }
|
|
157
|
-
*/
|
|
158
|
-
getAgent(agentId: UUID): IAgentRuntime | undefined;
|
|
159
|
-
}
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"elizaos.d.ts","sourceRoot":"","sources":["../../src/types/elizaos.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,KAAK,EACV,wBAAwB,EACxB,uBAAuB,EACxB,MAAM,6BAA6B,CAAC;AAErC;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,IAAI,CAAC;IACd,SAAS,EAAE,SAAS,GAAG,QAAQ,GAAG,UAAU,CAAC;IAC7C,OAAO,EAAE,GAAG,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,IAAI,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,GAAG,CAAC;IACb,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,EAAE,IAAI,GAAG,aAAa,GAAG,SAAS,CAAC;IAC9C,SAAS,IAAI,aAAa,EAAE,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,IAAI,GAAG,KAAK,GAAG,SAAS,CAAC;CAC5C;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,OAAO,CAAC;IACf,UAAU,EAAE,OAAO,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,IAAI,CAAC;IACT,SAAS,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;CAC/B;AAED;;;GAGG;AACH,MAAM,WAAW,oBAAqB,SAAQ,wBAAwB;IACpE;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjD;;OAEG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1C;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,6BAA6B;IAC7B,SAAS,EAAE,IAAI,CAAC;IAEhB,wCAAwC;IACxC,WAAW,EAAE,MAAM,CAAC;IAEpB;;;;OAIG;IACH,UAAU,CAAC,EAAE,uBAAuB,CAAC;CACtC;AAED;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACvB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6CG;IACH,aAAa,CACX,OAAO,EAAE,IAAI,EACb,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG;QACzB,QAAQ,EAAE,IAAI,CAAC;QACf,MAAM,EAAE,IAAI,CAAC;QACb,OAAO,EAAE,OAAO,CAAC;QACjB,OAAO,CAAC,EAAE,IAAI,CAAC;KAChB,EACD,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAEhC;;;;;;;;;;;;;;;OAeG;IACH,QAAQ,CAAC,OAAO,EAAE,IAAI,GAAG,aAAa,GAAG,SAAS,CAAC;CACpD"}
|