@elizaos/core 1.6.5 → 1.7.0-beta.0
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/dist/browser/index.browser.js +121 -121
- package/dist/browser/index.browser.js.map +32 -29
- package/dist/database.d.ts +4 -7
- package/dist/database.d.ts.map +1 -1
- package/dist/elizaos.d.ts +13 -54
- package/dist/elizaos.d.ts.map +1 -1
- package/dist/entities.d.ts +0 -8
- package/dist/entities.d.ts.map +1 -1
- package/dist/index.browser.d.ts +1 -0
- package/dist/index.browser.d.ts.map +1 -1
- package/dist/index.d.ts +2 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/index.node.d.ts +2 -0
- package/dist/index.node.d.ts.map +1 -1
- package/dist/logger.d.ts +26 -0
- package/dist/logger.d.ts.map +1 -1
- package/dist/node/index.node.js +1377 -1116
- package/dist/node/index.node.js.map +34 -31
- package/dist/plugin.d.ts.map +1 -1
- package/dist/roles.d.ts +0 -6
- package/dist/roles.d.ts.map +1 -1
- package/dist/runtime.d.ts +22 -19
- package/dist/runtime.d.ts.map +1 -1
- package/dist/schemas/character.d.ts +2 -2
- package/dist/schemas/character.d.ts.map +1 -1
- package/dist/search.d.ts +8 -8
- package/dist/search.d.ts.map +1 -1
- package/dist/services/default-message-service.d.ts.map +1 -1
- package/dist/services/message-service.d.ts +11 -2
- package/dist/services/message-service.d.ts.map +1 -1
- package/dist/services.d.ts +10 -2
- package/dist/services.d.ts.map +1 -1
- package/dist/settings.d.ts +9 -9
- package/dist/settings.d.ts.map +1 -1
- package/dist/streaming-context.browser.d.ts +27 -0
- package/dist/streaming-context.browser.d.ts.map +1 -0
- package/dist/streaming-context.d.ts +79 -0
- package/dist/streaming-context.d.ts.map +1 -0
- package/dist/streaming-context.node.d.ts +16 -0
- package/dist/streaming-context.node.d.ts.map +1 -0
- package/dist/types/agent.d.ts +1 -1
- package/dist/types/agent.d.ts.map +1 -1
- package/dist/types/components.d.ts +2 -2
- package/dist/types/components.d.ts.map +1 -1
- package/dist/types/database.d.ts +93 -8
- package/dist/types/database.d.ts.map +1 -1
- package/dist/types/elizaos.d.ts +53 -25
- package/dist/types/elizaos.d.ts.map +1 -1
- package/dist/types/events.d.ts +15 -4
- package/dist/types/events.d.ts.map +1 -1
- package/dist/types/index.d.ts +2 -1
- package/dist/types/index.d.ts.map +1 -1
- package/dist/types/messaging.d.ts +51 -0
- package/dist/types/messaging.d.ts.map +1 -1
- package/dist/types/model.d.ts +119 -12
- package/dist/types/model.d.ts.map +1 -1
- package/dist/types/plugin.d.ts +35 -7
- package/dist/types/plugin.d.ts.map +1 -1
- package/dist/types/primitives.d.ts +6 -0
- package/dist/types/primitives.d.ts.map +1 -1
- package/dist/types/runtime.d.ts +35 -14
- package/dist/types/runtime.d.ts.map +1 -1
- package/dist/types/service.d.ts +7 -5
- package/dist/types/service.d.ts.map +1 -1
- package/dist/types/settings.d.ts +2 -2
- package/dist/types/settings.d.ts.map +1 -1
- package/dist/types/state.d.ts +42 -7
- package/dist/types/state.d.ts.map +1 -1
- package/dist/types/streaming.d.ts +46 -0
- package/dist/types/streaming.d.ts.map +1 -0
- package/dist/utils/buffer.d.ts +1 -1
- package/dist/utils/buffer.d.ts.map +1 -1
- package/dist/utils/crypto-compat.d.ts.map +1 -1
- package/dist/utils/environment.d.ts.map +1 -1
- package/dist/utils/paths.d.ts.map +1 -1
- package/dist/utils/server-health.d.ts.map +1 -1
- package/dist/utils/streaming.d.ts +116 -0
- package/dist/utils/streaming.d.ts.map +1 -0
- package/dist/utils.d.ts +10 -4
- package/dist/utils.d.ts.map +1 -1
- package/package.json +3 -3
package/dist/types/model.d.ts
CHANGED
|
@@ -199,7 +199,93 @@ export type GenerateTextParams = {
|
|
|
199
199
|
responseFormat?: {
|
|
200
200
|
type: 'json_object' | 'text';
|
|
201
201
|
} | string;
|
|
202
|
+
/**
|
|
203
|
+
* Enable or disable streaming mode.
|
|
204
|
+
* - `true`: Force streaming (requires onStreamChunk or context)
|
|
205
|
+
* - `false`: Force non-streaming even if callback exists
|
|
206
|
+
* - `undefined`: Auto (streams if onStreamChunk or context exists)
|
|
207
|
+
*/
|
|
208
|
+
stream?: boolean;
|
|
209
|
+
/**
|
|
210
|
+
* Optional. Callback function for receiving streaming chunks.
|
|
211
|
+
* When provided, streaming is automatically enabled and chunks are sent to this callback.
|
|
212
|
+
*
|
|
213
|
+
* @example
|
|
214
|
+
* ```typescript
|
|
215
|
+
* const text = await runtime.useModel(ModelType.TEXT_LARGE, {
|
|
216
|
+
* prompt: "Hello",
|
|
217
|
+
* onStreamChunk: (chunk) => process.stdout.write(chunk)
|
|
218
|
+
* });
|
|
219
|
+
* ```
|
|
220
|
+
*/
|
|
221
|
+
onStreamChunk?: (chunk: string, messageId?: string) => void | Promise<void>;
|
|
202
222
|
};
|
|
223
|
+
/**
|
|
224
|
+
* Token usage information from a model response.
|
|
225
|
+
* Provides metrics about token consumption for billing and monitoring.
|
|
226
|
+
*/
|
|
227
|
+
export interface TokenUsage {
|
|
228
|
+
/** Number of tokens in the input prompt */
|
|
229
|
+
promptTokens: number;
|
|
230
|
+
/** Number of tokens in the generated response */
|
|
231
|
+
completionTokens: number;
|
|
232
|
+
/** Total tokens used (promptTokens + completionTokens) */
|
|
233
|
+
totalTokens: number;
|
|
234
|
+
}
|
|
235
|
+
/**
|
|
236
|
+
* Represents a single chunk in a text stream.
|
|
237
|
+
* Each chunk contains a piece of the generated text.
|
|
238
|
+
*/
|
|
239
|
+
export interface TextStreamChunk {
|
|
240
|
+
/** The text content of this chunk */
|
|
241
|
+
text: string;
|
|
242
|
+
/** Whether this is the final chunk in the stream */
|
|
243
|
+
done: boolean;
|
|
244
|
+
}
|
|
245
|
+
/**
|
|
246
|
+
* Result of a streaming text generation request.
|
|
247
|
+
* Provides an async iterable for consuming text chunks as they arrive.
|
|
248
|
+
*
|
|
249
|
+
* @example
|
|
250
|
+
* ```typescript
|
|
251
|
+
* const result = await runtime.useModel(ModelType.TEXT_LARGE, {
|
|
252
|
+
* prompt: "Hello",
|
|
253
|
+
* stream: true
|
|
254
|
+
* }) as TextStreamResult;
|
|
255
|
+
*
|
|
256
|
+
* let fullText = '';
|
|
257
|
+
* for await (const chunk of result.textStream) {
|
|
258
|
+
* fullText += chunk;
|
|
259
|
+
* console.log('Received:', chunk);
|
|
260
|
+
* }
|
|
261
|
+
*
|
|
262
|
+
* // After stream completes
|
|
263
|
+
* const usage = await result.usage;
|
|
264
|
+
* console.log('Total tokens:', usage.totalTokens);
|
|
265
|
+
* ```
|
|
266
|
+
*/
|
|
267
|
+
export interface TextStreamResult {
|
|
268
|
+
/**
|
|
269
|
+
* Async iterable that yields text chunks as they are generated.
|
|
270
|
+
* Each iteration provides a string chunk of the response.
|
|
271
|
+
*/
|
|
272
|
+
textStream: AsyncIterable<string>;
|
|
273
|
+
/**
|
|
274
|
+
* Promise that resolves to the complete text after streaming finishes.
|
|
275
|
+
* Useful when you need the full response after streaming.
|
|
276
|
+
*/
|
|
277
|
+
text: Promise<string>;
|
|
278
|
+
/**
|
|
279
|
+
* Promise that resolves to token usage information after streaming completes.
|
|
280
|
+
* May be undefined if the provider doesn't report usage for streaming.
|
|
281
|
+
*/
|
|
282
|
+
usage: Promise<TokenUsage | undefined>;
|
|
283
|
+
/**
|
|
284
|
+
* Promise that resolves to the finish reason after streaming completes.
|
|
285
|
+
* Common values: 'stop', 'length', 'content-filter'
|
|
286
|
+
*/
|
|
287
|
+
finishReason: Promise<string | undefined>;
|
|
288
|
+
}
|
|
203
289
|
/**
|
|
204
290
|
* Options for the simplified generateText API.
|
|
205
291
|
* Extends GenerateTextParams with additional configuration for character context.
|
|
@@ -311,10 +397,12 @@ export interface VideoProcessingParams {
|
|
|
311
397
|
*/
|
|
312
398
|
export type JSONSchema = {
|
|
313
399
|
type: string;
|
|
314
|
-
properties?: Record<string,
|
|
400
|
+
properties?: Record<string, JSONSchema | {
|
|
401
|
+
type: string;
|
|
402
|
+
}>;
|
|
315
403
|
required?: string[];
|
|
316
404
|
items?: JSONSchema;
|
|
317
|
-
[key: string]:
|
|
405
|
+
[key: string]: unknown;
|
|
318
406
|
};
|
|
319
407
|
/**
|
|
320
408
|
* Parameters for object generation models
|
|
@@ -355,10 +443,17 @@ export interface ModelParamsMap {
|
|
|
355
443
|
[ModelType.VIDEO]: VideoProcessingParams;
|
|
356
444
|
[ModelType.OBJECT_SMALL]: ObjectGenerationParams;
|
|
357
445
|
[ModelType.OBJECT_LARGE]: ObjectGenerationParams;
|
|
358
|
-
[
|
|
446
|
+
[ModelType.TEXT_COMPLETION]: GenerateTextParams;
|
|
359
447
|
}
|
|
360
448
|
/**
|
|
361
|
-
* Map of model types to their return value types
|
|
449
|
+
* Map of model types to their DEFAULT return value types.
|
|
450
|
+
*
|
|
451
|
+
* Note: For text generation models (TEXT_SMALL, TEXT_LARGE, TEXT_REASONING_*),
|
|
452
|
+
* the actual return type depends on the parameters and is handled by overloads:
|
|
453
|
+
* - `{ prompt }`: Returns `string` (this default)
|
|
454
|
+
* - `{ prompt, stream: true }`: Returns `TextStreamResult` (via overload)
|
|
455
|
+
*
|
|
456
|
+
* The overloads in IAgentRuntime.useModel() provide the correct type inference.
|
|
362
457
|
*/
|
|
363
458
|
export interface ModelResultMap {
|
|
364
459
|
[ModelType.TEXT_SMALL]: string;
|
|
@@ -376,13 +471,25 @@ export interface ModelResultMap {
|
|
|
376
471
|
description: string;
|
|
377
472
|
};
|
|
378
473
|
[ModelType.TRANSCRIPTION]: string;
|
|
379
|
-
[ModelType.TEXT_TO_SPEECH]:
|
|
380
|
-
[ModelType.AUDIO]:
|
|
381
|
-
[ModelType.VIDEO]:
|
|
382
|
-
[ModelType.OBJECT_SMALL]:
|
|
383
|
-
[ModelType.OBJECT_LARGE]:
|
|
384
|
-
[
|
|
474
|
+
[ModelType.TEXT_TO_SPEECH]: Buffer | ArrayBuffer | Uint8Array;
|
|
475
|
+
[ModelType.AUDIO]: Buffer | ArrayBuffer | Uint8Array | Record<string, unknown>;
|
|
476
|
+
[ModelType.VIDEO]: Buffer | ArrayBuffer | Uint8Array | Record<string, unknown>;
|
|
477
|
+
[ModelType.OBJECT_SMALL]: Record<string, unknown>;
|
|
478
|
+
[ModelType.OBJECT_LARGE]: Record<string, unknown>;
|
|
479
|
+
[ModelType.TEXT_COMPLETION]: string;
|
|
385
480
|
}
|
|
481
|
+
/**
|
|
482
|
+
* Models that support streaming - their handlers can return either string or TextStreamResult
|
|
483
|
+
*/
|
|
484
|
+
export type StreamableModelType = typeof ModelType.TEXT_SMALL | typeof ModelType.TEXT_LARGE | typeof ModelType.TEXT_REASONING_SMALL | typeof ModelType.TEXT_REASONING_LARGE | typeof ModelType.TEXT_COMPLETION;
|
|
485
|
+
/**
|
|
486
|
+
* Result type for plugin model handlers - includes TextStreamResult for streamable models
|
|
487
|
+
*/
|
|
488
|
+
export type PluginModelResult<K extends keyof ModelResultMap> = K extends StreamableModelType ? ModelResultMap[K] | TextStreamResult : ModelResultMap[K];
|
|
489
|
+
/**
|
|
490
|
+
* Type guard to check if a model type supports streaming.
|
|
491
|
+
*/
|
|
492
|
+
export declare function isStreamableModelType(modelType: ModelTypeName): boolean;
|
|
386
493
|
/**
|
|
387
494
|
* Defines the structure for a model handler registration within the `AgentRuntime`.
|
|
388
495
|
* Each model (e.g., for text generation, embedding) is associated with a handler function,
|
|
@@ -391,9 +498,9 @@ export interface ModelResultMap {
|
|
|
391
498
|
* handlers are registered for the same model type. The `registrationOrder` (not in type, but used in runtime)
|
|
392
499
|
* serves as a tie-breaker. See `AgentRuntime.registerModel` and `AgentRuntime.getModel`.
|
|
393
500
|
*/
|
|
394
|
-
export interface ModelHandler {
|
|
501
|
+
export interface ModelHandler<TParams = Record<string, unknown>, TResult = unknown> {
|
|
395
502
|
/** The function that executes the model, taking runtime and parameters, and returning a Promise. */
|
|
396
|
-
handler: (runtime: IAgentRuntime, params:
|
|
503
|
+
handler: (runtime: IAgentRuntime, params: TParams) => Promise<TResult>;
|
|
397
504
|
/** The name of the provider (e.g., plugin name) that registered this model handler. */
|
|
398
505
|
provider: string;
|
|
399
506
|
/**
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../../src/types/model.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE/C,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,OAAO,SAAS,CAAC,GAAG,MAAM,CAAC;AAEhF;;;;;;;;;GASG;AACH,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;CAoBZ,CAAC;AAEX;;;GAGG;AACH,MAAM,MAAM,uBAAuB,GAC/B,OAAO,SAAS,CAAC,UAAU,GAC3B,OAAO,SAAS,CAAC,UAAU,GAC3B,OAAO,SAAS,CAAC,oBAAoB,GACrC,OAAO,SAAS,CAAC,oBAAoB,GACrC,OAAO,SAAS,CAAC,eAAe,CAAC;AAErC;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6FjB,CAAC;AAEX;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,oFAAoF;IACpF,MAAM,EAAE,MAAM,CAAC;IACf,0EAA0E;IAC1E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0EAA0E;IAC1E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8GAA8G;IAC9G,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;8EAE0E;IAC1E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;kGAC8F;IAC9F,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;kIAC8H;IAC9H,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wFAAwF;IACxF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;+DAC2D;IAC3D,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,2FAA2F;IAC3F,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,sFAAsF;IACtF,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,4FAA4F;IAC5F,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB;;;;;;;;;;;;;;;;OAgBG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB;8HAC0H;IAC1H,cAAc,CAAC,EAAE;QAAE,IAAI,EAAE,aAAa,GAAG,MAAM,CAAA;KAAE,GAAG,MAAM,CAAC;
|
|
1
|
+
{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../../src/types/model.ts"],"names":[],"mappings":"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"}
|
package/dist/types/plugin.d.ts
CHANGED
|
@@ -2,9 +2,35 @@ import type { Character } from './agent';
|
|
|
2
2
|
import type { Action, Evaluator, Provider } from './components';
|
|
3
3
|
import type { IDatabaseAdapter } from './database';
|
|
4
4
|
import type { EventHandler, EventPayloadMap } from './events';
|
|
5
|
+
import type { ModelParamsMap, PluginModelResult } from './model';
|
|
5
6
|
import type { IAgentRuntime } from './runtime';
|
|
6
7
|
import type { Service } from './service';
|
|
7
8
|
import type { TestSuite } from './testing';
|
|
9
|
+
/**
|
|
10
|
+
* Minimal request interface
|
|
11
|
+
* Plugins can use this type for route handlers
|
|
12
|
+
*/
|
|
13
|
+
export interface RouteRequest {
|
|
14
|
+
body?: unknown;
|
|
15
|
+
params?: Record<string, string>;
|
|
16
|
+
query?: Record<string, unknown>;
|
|
17
|
+
headers?: Record<string, string | string[] | undefined>;
|
|
18
|
+
method?: string;
|
|
19
|
+
path?: string;
|
|
20
|
+
url?: string;
|
|
21
|
+
}
|
|
22
|
+
/**
|
|
23
|
+
* Minimal response interface
|
|
24
|
+
* Plugins can use this type for route handlers
|
|
25
|
+
*/
|
|
26
|
+
export interface RouteResponse {
|
|
27
|
+
status: (code: number) => RouteResponse;
|
|
28
|
+
json: (data: unknown) => RouteResponse;
|
|
29
|
+
send: (data: unknown) => RouteResponse;
|
|
30
|
+
end: () => RouteResponse;
|
|
31
|
+
setHeader?: (name: string, value: string | string[]) => RouteResponse;
|
|
32
|
+
headersSent?: boolean;
|
|
33
|
+
}
|
|
8
34
|
export type Route = {
|
|
9
35
|
type: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'STATIC';
|
|
10
36
|
path: string;
|
|
@@ -13,7 +39,7 @@ export type Route = {
|
|
|
13
39
|
name?: string extends {
|
|
14
40
|
public: true;
|
|
15
41
|
} ? string : string | undefined;
|
|
16
|
-
handler?: (req:
|
|
42
|
+
handler?: (req: RouteRequest, res: RouteResponse, runtime: IAgentRuntime) => Promise<void>;
|
|
17
43
|
isMultipart?: boolean;
|
|
18
44
|
};
|
|
19
45
|
/**
|
|
@@ -21,28 +47,30 @@ export type Route = {
|
|
|
21
47
|
*/
|
|
22
48
|
export type PluginEvents = {
|
|
23
49
|
[K in keyof EventPayloadMap]?: EventHandler<K>[];
|
|
24
|
-
}
|
|
25
|
-
|
|
50
|
+
};
|
|
51
|
+
/** Internal type for runtime event storage - allows dynamic access for event registration */
|
|
52
|
+
export type RuntimeEventStorage = PluginEvents & {
|
|
53
|
+
[key: string]: ((params: unknown) => Promise<void>)[] | undefined;
|
|
26
54
|
};
|
|
27
55
|
export interface Plugin {
|
|
28
56
|
name: string;
|
|
29
57
|
description: string;
|
|
30
58
|
init?: (config: Record<string, string>, runtime: IAgentRuntime) => Promise<void>;
|
|
31
59
|
config?: {
|
|
32
|
-
[key: string]:
|
|
60
|
+
[key: string]: string | number | boolean | null | undefined;
|
|
33
61
|
};
|
|
34
62
|
services?: (typeof Service)[];
|
|
35
63
|
componentTypes?: {
|
|
36
64
|
name: string;
|
|
37
65
|
schema: Record<string, unknown>;
|
|
38
|
-
validator?: (data:
|
|
66
|
+
validator?: (data: unknown) => boolean;
|
|
39
67
|
}[];
|
|
40
68
|
actions?: Action[];
|
|
41
69
|
providers?: Provider[];
|
|
42
70
|
evaluators?: Evaluator[];
|
|
43
71
|
adapter?: IDatabaseAdapter;
|
|
44
72
|
models?: {
|
|
45
|
-
[
|
|
73
|
+
[K in keyof ModelParamsMap]?: (runtime: IAgentRuntime, params: ModelParamsMap[K]) => Promise<PluginModelResult<K>>;
|
|
46
74
|
};
|
|
47
75
|
events?: PluginEvents;
|
|
48
76
|
routes?: Route[];
|
|
@@ -50,7 +78,7 @@ export interface Plugin {
|
|
|
50
78
|
dependencies?: string[];
|
|
51
79
|
testDependencies?: string[];
|
|
52
80
|
priority?: number;
|
|
53
|
-
schema?:
|
|
81
|
+
schema?: Record<string, unknown>;
|
|
54
82
|
}
|
|
55
83
|
export interface ProjectAgent {
|
|
56
84
|
character: Character;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../src/types/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAChE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAC9D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAE3C,MAAM,MAAM,KAAK,GAAG;IAClB,IAAI,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAC7D,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,SAAS;QAAE,MAAM,EAAE,IAAI,CAAA;KAAE,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IACrE,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,
|
|
1
|
+
{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../src/types/plugin.ts"],"names":[],"mappings":"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"}
|
|
@@ -35,6 +35,12 @@ export interface Content {
|
|
|
35
35
|
channelType?: ChannelType;
|
|
36
36
|
/** Platform-provided metadata about mentions */
|
|
37
37
|
mentionContext?: MentionContext;
|
|
38
|
+
/**
|
|
39
|
+
* Internal message ID used for streaming coordination.
|
|
40
|
+
* Set during response generation to ensure streaming chunks and
|
|
41
|
+
* final broadcast use the same message ID.
|
|
42
|
+
*/
|
|
43
|
+
responseMessageId?: UUID;
|
|
38
44
|
/**
|
|
39
45
|
* Additional dynamic properties
|
|
40
46
|
* Use specific properties above instead of this when possible
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"primitives.d.ts","sourceRoot":"","sources":["../../src/types/primitives.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD;;GAEG;AACH,MAAM,MAAM,IAAI,GAAG,GAAG,MAAM,IAAI,MAAM,IAAI,MAAM,IAAI,MAAM,IAAI,MAAM,EAAE,CAAC;AAEvE;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAKvC;AAED;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,2CAA2C;IAC3C,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,6CAA6C;IAC7C,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,uCAAuC;IACvC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IAEnB,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IAErB,4CAA4C;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,gDAAgD;IAChD,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,8EAA8E;IAC9E,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb,uDAAuD;IACvD,SAAS,CAAC,EAAE,IAAI,CAAC;IAEjB,iCAAiC;IACjC,WAAW,CAAC,EAAE,KAAK,EAAE,CAAC;IAEtB,gBAAgB;IAChB,WAAW,CAAC,EAAE,WAAW,CAAC;IAE1B,gDAAgD;IAChD,cAAc,CAAC,EAAE,cAAc,CAAC;IAEhC;;;OAGG;IACH,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,0DAA0D;IAC1D,SAAS,EAAE,OAAO,CAAC;IAEnB,+BAA+B;IAC/B,OAAO,EAAE,OAAO,CAAC;IAEjB,6BAA6B;IAC7B,QAAQ,EAAE,OAAO,CAAC;IAElB,2DAA2D;IAC3D,WAAW,CAAC,EAAE,kBAAkB,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;CAChE;AAED;;GAEG;AACH,MAAM,MAAM,KAAK,GAAG;IAClB,wBAAwB;IACxB,EAAE,EAAE,MAAM,CAAC;IAEX,gBAAgB;IAChB,GAAG,EAAE,MAAM,CAAC;IAEZ,kBAAkB;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,mBAAmB;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,wBAAwB;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,mBAAmB;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,mBAAmB;IACnB,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B,CAAC;AAEF,oBAAY,WAAW;IACrB,KAAK,UAAU;IACf,KAAK,UAAU;IACf,KAAK,UAAU;IACf,QAAQ,aAAa;IACrB,IAAI,SAAS;CACd;AAED;;;GAGG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC"}
|
|
1
|
+
{"version":3,"file":"primitives.d.ts","sourceRoot":"","sources":["../../src/types/primitives.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD;;GAEG;AACH,MAAM,MAAM,IAAI,GAAG,GAAG,MAAM,IAAI,MAAM,IAAI,MAAM,IAAI,MAAM,IAAI,MAAM,EAAE,CAAC;AAEvE;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAKvC;AAED;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,2CAA2C;IAC3C,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,6CAA6C;IAC7C,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,uCAAuC;IACvC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IAEnB,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IAErB,4CAA4C;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,gDAAgD;IAChD,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,8EAA8E;IAC9E,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb,uDAAuD;IACvD,SAAS,CAAC,EAAE,IAAI,CAAC;IAEjB,iCAAiC;IACjC,WAAW,CAAC,EAAE,KAAK,EAAE,CAAC;IAEtB,gBAAgB;IAChB,WAAW,CAAC,EAAE,WAAW,CAAC;IAE1B,gDAAgD;IAChD,cAAc,CAAC,EAAE,cAAc,CAAC;IAEhC;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,IAAI,CAAC;IAEzB;;;OAGG;IACH,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,0DAA0D;IAC1D,SAAS,EAAE,OAAO,CAAC;IAEnB,+BAA+B;IAC/B,OAAO,EAAE,OAAO,CAAC;IAEjB,6BAA6B;IAC7B,QAAQ,EAAE,OAAO,CAAC;IAElB,2DAA2D;IAC3D,WAAW,CAAC,EAAE,kBAAkB,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;CAChE;AAED;;GAEG;AACH,MAAM,MAAM,KAAK,GAAG;IAClB,wBAAwB;IACxB,EAAE,EAAE,MAAM,CAAC;IAEX,gBAAgB;IAChB,GAAG,EAAE,MAAM,CAAC;IAEZ,kBAAkB;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,mBAAmB;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,wBAAwB;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,mBAAmB;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,mBAAmB;IACnB,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B,CAAC;AAEF,oBAAY,WAAW;IACrB,KAAK,UAAU;IACf,KAAK,UAAU;IACf,KAAK,UAAU;IACf,QAAQ,aAAa;IACrB,IAAI,SAAS;CACd;AAED;;;GAGG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC"}
|
package/dist/types/runtime.d.ts
CHANGED
|
@@ -8,12 +8,13 @@ import type { Logger } from '../logger';
|
|
|
8
8
|
import { Memory, MemoryMetadata } from './memory';
|
|
9
9
|
import type { SendHandlerFunction, TargetInfo } from './messaging';
|
|
10
10
|
import type { IMessageService } from '../services/message-service';
|
|
11
|
-
import type { ModelParamsMap, ModelResultMap, ModelTypeName, GenerateTextOptions, GenerateTextResult } from './model';
|
|
12
|
-
import type { Plugin,
|
|
11
|
+
import type { ModelParamsMap, ModelResultMap, ModelTypeName, GenerateTextOptions, GenerateTextResult, GenerateTextParams, TextGenerationModelType } from './model';
|
|
12
|
+
import type { Plugin, RuntimeEventStorage, Route } from './plugin';
|
|
13
13
|
import type { Content, UUID } from './primitives';
|
|
14
14
|
import type { Service, ServiceTypeName } from './service';
|
|
15
15
|
import type { State } from './state';
|
|
16
16
|
import type { TaskWorker } from './task';
|
|
17
|
+
import type { EventPayloadMap, EventHandler, EventPayload } from './events';
|
|
17
18
|
/**
|
|
18
19
|
* Represents the core runtime environment for an agent.
|
|
19
20
|
* Defines methods for database interaction, plugin management, event handling,
|
|
@@ -22,13 +23,14 @@ import type { TaskWorker } from './task';
|
|
|
22
23
|
export interface IAgentRuntime extends IDatabaseAdapter {
|
|
23
24
|
agentId: UUID;
|
|
24
25
|
character: Character;
|
|
26
|
+
initPromise: Promise<void>;
|
|
25
27
|
messageService: IMessageService | null;
|
|
26
28
|
providers: Provider[];
|
|
27
29
|
actions: Action[];
|
|
28
30
|
evaluators: Evaluator[];
|
|
29
31
|
plugins: Plugin[];
|
|
30
32
|
services: Map<ServiceTypeName, Service[]>;
|
|
31
|
-
events:
|
|
33
|
+
events: RuntimeEventStorage;
|
|
32
34
|
fetch?: typeof fetch | null;
|
|
33
35
|
routes: Route[];
|
|
34
36
|
logger: Logger;
|
|
@@ -38,7 +40,7 @@ export interface IAgentRuntime extends IDatabaseAdapter {
|
|
|
38
40
|
initialize(options?: {
|
|
39
41
|
skipMigrations?: boolean;
|
|
40
42
|
}): Promise<void>;
|
|
41
|
-
getConnection(): Promise<
|
|
43
|
+
getConnection(): Promise<unknown>;
|
|
42
44
|
getService<T extends Service>(service: ServiceTypeName | string): T | null;
|
|
43
45
|
getServicesByType<T extends Service>(service: ServiceTypeName | string): T[];
|
|
44
46
|
getAllServices(): Map<ServiceTypeName, Service[]>;
|
|
@@ -50,10 +52,12 @@ export interface IAgentRuntime extends IDatabaseAdapter {
|
|
|
50
52
|
elizaOS: IElizaOS;
|
|
51
53
|
};
|
|
52
54
|
registerDatabaseAdapter(adapter: IDatabaseAdapter): void;
|
|
53
|
-
setSetting(key: string, value: string | boolean | null
|
|
54
|
-
getSetting(key: string): string | boolean |
|
|
55
|
+
setSetting(key: string, value: string | boolean | null, secret?: boolean): void;
|
|
56
|
+
getSetting(key: string): string | boolean | number | null;
|
|
55
57
|
getConversationLength(): number;
|
|
56
|
-
processActions(message: Memory, responses: Memory[], state?: State, callback?: HandlerCallback
|
|
58
|
+
processActions(message: Memory, responses: Memory[], state?: State, callback?: HandlerCallback, options?: {
|
|
59
|
+
onStreamChunk?: (chunk: string, messageId?: UUID) => Promise<void>;
|
|
60
|
+
}): Promise<void>;
|
|
57
61
|
getActionResults(messageId: UUID): ActionResult[];
|
|
58
62
|
evaluate(message: Memory, state?: State, didRespond?: boolean, callback?: HandlerCallback, responses?: Memory[]): Promise<Evaluator[] | null>;
|
|
59
63
|
registerProvider(provider: Provider): void;
|
|
@@ -72,19 +76,36 @@ export interface IAgentRuntime extends IDatabaseAdapter {
|
|
|
72
76
|
type?: ChannelType | string;
|
|
73
77
|
worldId: UUID;
|
|
74
78
|
userId?: UUID;
|
|
75
|
-
metadata?: Record<string,
|
|
79
|
+
metadata?: Record<string, unknown>;
|
|
76
80
|
}): Promise<void>;
|
|
77
81
|
ensureParticipantInRoom(entityId: UUID, roomId: UUID): Promise<void>;
|
|
78
82
|
ensureWorldExists(world: World): Promise<void>;
|
|
79
83
|
ensureRoomExists(room: Room): Promise<void>;
|
|
80
84
|
composeState(message: Memory, includeList?: string[], onlyInclude?: boolean, skipCache?: boolean): Promise<State>;
|
|
81
|
-
|
|
85
|
+
/**
|
|
86
|
+
* Use a model for inference with proper type inference based on parameters.
|
|
87
|
+
*
|
|
88
|
+
* For text generation models (TEXT_SMALL, TEXT_LARGE, TEXT_REASONING_*):
|
|
89
|
+
* - Always returns `string`
|
|
90
|
+
* - If streaming context is active, chunks are sent to callback automatically
|
|
91
|
+
*
|
|
92
|
+
* @example
|
|
93
|
+
* ```typescript
|
|
94
|
+
* // Simple usage - streaming happens automatically if context is active
|
|
95
|
+
* const text = await runtime.useModel(ModelType.TEXT_LARGE, { prompt: "Hello" });
|
|
96
|
+
* ```
|
|
97
|
+
*/
|
|
98
|
+
useModel(modelType: TextGenerationModelType, params: GenerateTextParams, provider?: string): Promise<string>;
|
|
99
|
+
useModel<T extends keyof ModelParamsMap, R = ModelResultMap[T]>(modelType: T, params: ModelParamsMap[T], provider?: string): Promise<R>;
|
|
82
100
|
generateText(input: string, options?: GenerateTextOptions): Promise<GenerateTextResult>;
|
|
83
|
-
registerModel(modelType: ModelTypeName | string, handler: (params:
|
|
84
|
-
getModel(modelType: ModelTypeName | string): ((runtime: IAgentRuntime, params:
|
|
85
|
-
registerEvent(event:
|
|
86
|
-
|
|
87
|
-
|
|
101
|
+
registerModel(modelType: ModelTypeName | string, handler: (runtime: IAgentRuntime, params: Record<string, unknown>) => Promise<unknown>, provider: string, priority?: number): void;
|
|
102
|
+
getModel(modelType: ModelTypeName | string): ((runtime: IAgentRuntime, params: Record<string, unknown>) => Promise<unknown>) | undefined;
|
|
103
|
+
registerEvent<T extends keyof EventPayloadMap>(event: T, handler: EventHandler<T>): void;
|
|
104
|
+
registerEvent(event: string, handler: (params: EventPayload) => Promise<void>): void;
|
|
105
|
+
getEvent<T extends keyof EventPayloadMap>(event: T): EventHandler<T>[] | undefined;
|
|
106
|
+
getEvent(event: string): ((params: EventPayload) => Promise<void>)[] | undefined;
|
|
107
|
+
emitEvent<T extends keyof EventPayloadMap>(event: T | T[], params: EventPayloadMap[T]): Promise<void>;
|
|
108
|
+
emitEvent(event: string | string[], params: EventPayload): Promise<void>;
|
|
88
109
|
registerTaskWorker(taskHandler: TaskWorker): void;
|
|
89
110
|
getTaskWorker(name: string): TaskWorker | undefined;
|
|
90
111
|
stop(): Promise<void>;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/types/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC9E,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACtE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAClD,OAAO,KAAK,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACnE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,KAAK,EACV,cAAc,EACd,cAAc,EACd,aAAa,EACb,mBAAmB,EACnB,kBAAkB,
|
|
1
|
+
{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/types/runtime.ts"],"names":[],"mappings":"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"}
|
package/dist/types/service.d.ts
CHANGED
|
@@ -107,14 +107,16 @@ export declare abstract class Service {
|
|
|
107
107
|
/** Start service connection */
|
|
108
108
|
static start(_runtime: IAgentRuntime): Promise<Service>;
|
|
109
109
|
/** Stop service connection */
|
|
110
|
-
static stop(_runtime: IAgentRuntime): Promise<
|
|
110
|
+
static stop(_runtime: IAgentRuntime): Promise<void>;
|
|
111
|
+
/** Optional static method to register send handlers */
|
|
112
|
+
static registerSendHandlers?(runtime: IAgentRuntime, service: Service): void;
|
|
111
113
|
}
|
|
112
114
|
/**
|
|
113
115
|
* Generic service interface that provides better type checking for services
|
|
114
116
|
* @template ConfigType The configuration type for this service
|
|
115
117
|
* @template ResultType The result type returned by the service operations
|
|
116
118
|
*/
|
|
117
|
-
export interface TypedService<ConfigType extends Metadata = Metadata, ResultType = unknown> extends Service {
|
|
119
|
+
export interface TypedService<ConfigType extends Metadata = Metadata, InputType = unknown, ResultType = unknown> extends Service {
|
|
118
120
|
/**
|
|
119
121
|
* The configuration for this service instance
|
|
120
122
|
*/
|
|
@@ -124,7 +126,7 @@ export interface TypedService<ConfigType extends Metadata = Metadata, ResultType
|
|
|
124
126
|
* @param input The input to process
|
|
125
127
|
* @returns A promise resolving to the result
|
|
126
128
|
*/
|
|
127
|
-
process(input:
|
|
129
|
+
process(input: InputType): Promise<ResultType>;
|
|
128
130
|
}
|
|
129
131
|
/**
|
|
130
132
|
* Generic factory function to create a typed service instance
|
|
@@ -132,14 +134,14 @@ export interface TypedService<ConfigType extends Metadata = Metadata, ResultType
|
|
|
132
134
|
* @param serviceType The type of service to get
|
|
133
135
|
* @returns The service instance or null if not available
|
|
134
136
|
*/
|
|
135
|
-
export declare function getTypedService<
|
|
137
|
+
export declare function getTypedService<ConfigType extends Metadata = Metadata, InputType = unknown, ResultType = unknown>(runtime: IAgentRuntime, serviceType: ServiceTypeName): TypedService<ConfigType, InputType, ResultType> | null;
|
|
136
138
|
/**
|
|
137
139
|
* Standardized service error type for consistent error handling
|
|
138
140
|
*/
|
|
139
141
|
export interface ServiceError {
|
|
140
142
|
code: string;
|
|
141
143
|
message: string;
|
|
142
|
-
details?: unknown;
|
|
144
|
+
details?: Record<string, unknown> | string | number | boolean | null;
|
|
143
145
|
cause?: Error;
|
|
144
146
|
}
|
|
145
147
|
/**
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../src/types/service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE/C;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,mBAAmB;IAClC,aAAa,EAAE,eAAe,CAAC;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,SAAS,CAAC;IACnB,GAAG,EAAE,KAAK,CAAC;IACX,YAAY,EAAE,QAAQ,CAAC;IACvB,UAAU,EAAE,YAAY,CAAC;IACzB,KAAK,EAAE,OAAO,CAAC;IACf,GAAG,EAAE,KAAK,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,QAAQ,CAAC;IACjB,OAAO,EAAE,SAAS,CAAC;IACnB,UAAU,EAAE,YAAY,CAAC;IACzB,eAAe,EAAE,iBAAiB,CAAC;IACnC,OAAO,EAAE,SAAS,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,SAAS,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,mBAAmB,CAAC,MAAM,mBAAmB,CAAC,CAAC;AAE7E;;GAEG;AACH,MAAM,MAAM,gBAAgB,CAAC,CAAC,SAAS,MAAM,mBAAmB,IAAI,mBAAmB,CAAC,CAAC,CAAC,CAAC;AAE3F;;GAEG;AACH,MAAM,MAAM,kBAAkB,CAAC,CAAC,SAAS,MAAM,IAAI,CAAC,SAAS,eAAe,GAAG,IAAI,GAAG,KAAK,CAAC;AAE5F;;GAEG;AACH,MAAM,MAAM,iBAAiB,CAAC,CAAC,SAAS,eAAe,IAAI;IACzD,KAAK,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC;IACvC,WAAW,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACjD,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,eAAe;CAE/B;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,CAAC,CAAC,SAAS,eAAe,IAAI,CAAC,SAAS,MAAM,eAAe,GACpF,YAAY,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,GAChC,OAAO,CAAC;AAEZ;;GAEG;AACH,MAAM,MAAM,eAAe,CAAC,CAAC,SAAS,eAAe,GAAG,eAAe,IAAI,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;AAE3F;;;;;;;GAOG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;CAiBgB,CAAC;AAEzC;;GAEG;AACH,8BAAsB,OAAO;IAC3B,uBAAuB;IACvB,SAAS,CAAC,OAAO,EAAG,aAAa,CAAC;gBAEtB,OAAO,CAAC,EAAE,aAAa;IAMnC,QAAQ,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAE9B,mBAAmB;IACnB,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC;IAE3B,mBAAmB;IACnB,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAC;IAEvC,4BAA4B;IAC5B,MAAM,CAAC,EAAE,QAAQ,CAAC;IAElB,+BAA+B;WAClB,KAAK,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC;IAI7D,8BAA8B;WACjB,IAAI,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,
|
|
1
|
+
{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../src/types/service.ts"],"names":[],"mappings":"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"}
|
package/dist/types/settings.d.ts
CHANGED
|
@@ -12,9 +12,9 @@ export interface Setting {
|
|
|
12
12
|
required: boolean;
|
|
13
13
|
public?: boolean;
|
|
14
14
|
secret?: boolean;
|
|
15
|
-
validation?: (value:
|
|
15
|
+
validation?: (value: string | boolean | null) => boolean;
|
|
16
16
|
dependsOn?: string[];
|
|
17
|
-
onSetAction?: (value:
|
|
17
|
+
onSetAction?: (value: string | boolean | null) => string;
|
|
18
18
|
visibleIf?: (settings: {
|
|
19
19
|
[key: string]: Setting;
|
|
20
20
|
}) => boolean;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../../src/types/settings.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;CACnC;AAED,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;IAC/B,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,OAAO,CAAC;
|
|
1
|
+
{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../../src/types/settings.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;CACnC;AAED,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;IAC/B,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,KAAK,OAAO,CAAC;IACzD,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,KAAK,MAAM,CAAC;IACzD,SAAS,CAAC,EAAE,CAAC,QAAQ,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,KAAK,OAAO,CAAC;CAC/D;AAED,MAAM,WAAW,aAAa;IAC5B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE;QACR,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;KACvC,CAAC;CACH"}
|
package/dist/types/state.d.ts
CHANGED
|
@@ -1,22 +1,57 @@
|
|
|
1
|
+
import type { ActionResult } from './components';
|
|
2
|
+
import type { Entity, Room, World } from './environment';
|
|
3
|
+
/** Single step in an action plan */
|
|
4
|
+
export interface ActionPlanStep {
|
|
5
|
+
action: string;
|
|
6
|
+
status: 'pending' | 'completed' | 'failed';
|
|
7
|
+
error?: string;
|
|
8
|
+
result?: ActionResult;
|
|
9
|
+
}
|
|
10
|
+
/** Multi-step action plan */
|
|
11
|
+
export interface ActionPlan {
|
|
12
|
+
thought: string;
|
|
13
|
+
totalSteps: number;
|
|
14
|
+
currentStep: number;
|
|
15
|
+
steps: ActionPlanStep[];
|
|
16
|
+
}
|
|
17
|
+
/**
|
|
18
|
+
* Structured data cached in state by providers and actions.
|
|
19
|
+
* Common properties are typed for better DX while allowing dynamic extension.
|
|
20
|
+
*/
|
|
21
|
+
export interface StateData {
|
|
22
|
+
/** Cached room data from providers */
|
|
23
|
+
room?: Room;
|
|
24
|
+
/** Cached world data from providers */
|
|
25
|
+
world?: World;
|
|
26
|
+
/** Cached entity data from providers */
|
|
27
|
+
entity?: Entity;
|
|
28
|
+
/** Provider results cache keyed by provider name */
|
|
29
|
+
providers?: Record<string, Record<string, unknown>>;
|
|
30
|
+
/** Current action plan for multi-step actions */
|
|
31
|
+
actionPlan?: ActionPlan;
|
|
32
|
+
/** Results from previous action executions */
|
|
33
|
+
actionResults?: ActionResult[];
|
|
34
|
+
/** Allow additional dynamic properties */
|
|
35
|
+
[key: string]: unknown;
|
|
36
|
+
}
|
|
1
37
|
/**
|
|
2
38
|
* Represents the current state or context of a conversation or agent interaction.
|
|
3
39
|
* This interface is a flexible container for various pieces of information that define the agent's
|
|
4
40
|
* understanding at a point in time. It includes:
|
|
5
41
|
* - `values`: A key-value store for general state variables, often populated by providers.
|
|
6
|
-
* - `data`:
|
|
42
|
+
* - `data`: Structured data cache with typed common properties for room, world, entity, etc.
|
|
7
43
|
* - `text`: A string representation of the current context, often a summary or concatenated history.
|
|
8
|
-
* The `[key: string]:
|
|
44
|
+
* The `[key: string]: unknown;` allows for dynamic properties to be added as needed.
|
|
9
45
|
* This state object is passed to handlers for actions, evaluators, and providers.
|
|
10
46
|
*/
|
|
11
47
|
export interface State {
|
|
12
48
|
/** Additional dynamic properties */
|
|
13
|
-
[key: string]:
|
|
49
|
+
[key: string]: unknown;
|
|
14
50
|
values: {
|
|
15
|
-
[key: string]:
|
|
16
|
-
};
|
|
17
|
-
data: {
|
|
18
|
-
[key: string]: any;
|
|
51
|
+
[key: string]: unknown;
|
|
19
52
|
};
|
|
53
|
+
/** Structured data cache with typed properties */
|
|
54
|
+
data: StateData;
|
|
20
55
|
text: string;
|
|
21
56
|
}
|
|
22
57
|
//# sourceMappingURL=state.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../src/types/state.ts"],"names":[],"mappings":"AAAA
|
|
1
|
+
{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../src/types/state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAEzD,oCAAoC;AACpC,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;IAC3C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAED,6BAA6B;AAC7B,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,cAAc,EAAE,CAAC;CACzB;AAED;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB,sCAAsC;IACtC,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,uCAAuC;IACvC,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,wCAAwC;IACxC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oDAAoD;IACpD,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACpD,iDAAiD;IACjD,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,8CAA8C;IAC9C,aAAa,CAAC,EAAE,YAAY,EAAE,CAAC;IAC/B,0CAA0C;IAC1C,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,KAAK;IACpB,oCAAoC;IACpC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,MAAM,EAAE;QACN,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;IACF,kDAAkD;IAClD,IAAI,EAAE,SAAS,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd"}
|