@elizaos/ui 2.0.0-alpha.25 → 2.0.0-alpha.334

package/packages/typescript/src/features/basic-capabilities/providers/character.js

@@ -0,0 +1,190 @@
+import { requireProviderSpec } from "../../../generated/spec-helpers.js";
+import { ChannelType } from "../../../types/index.js";
+import { buildDeterministicSeed, deterministicPick, deterministicSample, getDeterministicNames, } from "../../../utils/deterministic";
+import { addHeader } from "../../../utils.js";
+// Get text content from centralized specs
+const spec = requireProviderSpec("CHARACTER");
+function resolveCharacterPlaceholders(text, agentName, exampleNames = []) {
+    let resolved = (text ?? "")
+        .replaceAll("{{agentName}}", agentName)
+        .replaceAll("{{name}}", agentName);
+    exampleNames.forEach((name, index) => {
+        const slot = index + 1;
+        resolved = resolved
+            .replaceAll(`{{name${slot}}}`, name)
+            .replaceAll(`{{user${slot}}}`, name);
+    });
+    return resolved;
+}
+function resolveCharacterList(items, agentName, exampleNames = []) {
+    return (items ?? []).flatMap((item) => item === undefined
+        ? []
+        : [resolveCharacterPlaceholders(item, agentName, exampleNames)]);
+}
+/**
+ * Character provider object.
+ * @typedef {Object} Provider
+ * @property {string} name - The name of the provider ("CHARACTER").
+ * @property {string} description - Description of the character information.
+ * @property {Function} get - Async function to get character information.
+ */
+/**
+ * Provides character information.
+ * @param {IAgentRuntime} runtime - The agent runtime.
+ * @param {Memory} message - The message memory.
+ * @param {State} state - The state of the character.
+ * @returns {Object} Object containing values, data, and text sections.
+ */
+export const characterProvider = {
+    name: spec.name,
+    description: spec.description,
+    get: async (runtime, message, state) => {
+        const character = runtime.character;
+        const characterSeed = buildDeterministicSeed(runtime.agentId, message.roomId, "CHARACTER");
+        // Character name
+        const agentName = character.name ?? "";
+        // Handle bio (random selection from array)
+        const bioArray = resolveCharacterList(character.bio ?? [], agentName);
+        const bioText = bioArray.length > 0
+            ? deterministicSample(bioArray, 10, buildDeterministicSeed(characterSeed, "bio")).join(" ")
+            : "";
+        const bio = addHeader(`# About ${agentName}`, bioText);
+        // System prompt
+        const system = resolveCharacterPlaceholders(character.system ?? "", agentName);
+        // Select random topic if available
+        const topicString = character.topics && character.topics.length > 0
+            ? resolveCharacterPlaceholders(deterministicPick(character.topics, buildDeterministicSeed(characterSeed, "topic")), agentName)
+            : null;
+        // postCreationTemplate in core prompts.ts
+        // Write a post that is {{adjective}} about {{topic}} (without mentioning {{topic}} directly), from the perspective of {{agentName}}. Do not add commentary or acknowledge this request, just write the post.
+        // Write a post that is {{Spartan is dirty}} about {{Spartan is currently}}
+        const topic = topicString || "";
+        // Format topics list
+        const topics = character.topics && character.topics.length > 0
+            ? `${agentName} is also interested in ${deterministicSample(resolveCharacterList(character.topics, agentName).filter((topic) => topic !== topicString), 5, buildDeterministicSeed(characterSeed, "topics"))
+                .map((topic, index, array) => {
+                if (index === array.length - 2) {
+                    return `${topic} and `;
+                }
+                if (index === array.length - 1) {
+                    return topic;
+                }
+                return `${topic}, `;
+            })
+                .join("")}`
+            : "";
+        // Select random adjective if available
+        const adjectiveString = character.adjectives && character.adjectives.length > 0
+            ? resolveCharacterPlaceholders(deterministicPick(character.adjectives, buildDeterministicSeed(characterSeed, "adjective")), agentName)
+            : "";
+        const adjective = adjectiveString || "";
+        // Format post examples
+        const postExamplesArray = character.postExamples ?? [];
+        const formattedCharacterPostExamples = postExamplesArray.length > 0
+            ? deterministicSample(postExamplesArray, 50, buildDeterministicSeed(characterSeed, "posts"))
+                .map((post) => resolveCharacterPlaceholders(`${post}`, agentName))
+                .join("\n")
+            : "";
+        const characterPostExamples = formattedCharacterPostExamples &&
+            formattedCharacterPostExamples.replaceAll("\n", "").length > 0
+            ? addHeader(`# Example Posts for ${agentName}`, formattedCharacterPostExamples)
+            : "";
+        // Format message examples
+        const messageExamplesArray = character.messageExamples ?? [];
+        const formattedCharacterMessageExamples = messageExamplesArray.length > 0
+            ? deterministicSample(messageExamplesArray, 5, buildDeterministicSeed(characterSeed, "message-examples"))
+                .map((group, index) => {
+                const exampleNames = getDeterministicNames(5, buildDeterministicSeed(characterSeed, "participants", index));
+                return group.examples
+                    .map((message) => {
+                    const messageContent = message.content;
+                    const actionsText = messageContent?.actions?.join(", ");
+                    const text = messageContent?.text ?? "";
+                    const exampleText = resolveCharacterPlaceholders(text, agentName, exampleNames);
+                    const messageString = `${resolveCharacterPlaceholders(message.name, agentName, exampleNames)}: ${exampleText}${actionsText ? ` (actions: ${actionsText})` : ""}`;
+                    return messageString;
+                })
+                    .join("\n");
+            })
+                .join("\n\n")
+            : "";
+        const characterMessageExamples = formattedCharacterMessageExamples &&
+            formattedCharacterMessageExamples.replaceAll("\n", "").length > 0
+            ? addHeader(`# Example Conversations for ${agentName}`, formattedCharacterMessageExamples)
+            : "";
+        const room = state.data.room ?? (await runtime.getRoom(message.roomId));
+        const roomType = room?.type;
+        const isPostFormat = roomType === ChannelType.FEED || roomType === ChannelType.THREAD;
+        // Style directions
+        const characterStyle = character.style;
+        const characterStyleAll = resolveCharacterList(characterStyle?.all || [], agentName);
+        const characterStylePost = resolveCharacterList(characterStyle?.post || [], agentName);
+        const postDirections = characterStyleAll.length > 0 || characterStylePost.length > 0
+            ? addHeader(`# Post Directions for ${agentName}`, [...characterStyleAll, ...characterStylePost].join("\n"))
+            : "";
+        const characterStyleChat = resolveCharacterList(characterStyle?.chat || [], agentName);
+        const messageDirections = characterStyleAll.length > 0 || characterStyleChat.length > 0
+            ? addHeader(`# Message Directions for ${agentName}`, [...characterStyleAll, ...characterStyleChat].join("\n"))
+            : "";
+        const directions = isPostFormat ? postDirections : messageDirections;
+        const examples = isPostFormat
+            ? characterPostExamples
+            : characterMessageExamples;
+        const values = {
+            agentName,
+            bio,
+            system,
+            topic,
+            topics,
+            adjective,
+            messageDirections,
+            postDirections,
+            directions,
+            examples,
+            characterPostExamples,
+            characterMessageExamples,
+        };
+        const data = {
+            bio,
+            adjective,
+            topic,
+            topics,
+            character,
+            directions,
+            examples,
+            system,
+        };
+        const topicSentence = topicString
+            ? `${agentName} is currently interested in ${topicString}`
+            : "";
+        const adjectiveSentence = adjectiveString
+            ? `${agentName} is ${adjectiveString}`
+            : "";
+        // Combine all text sections
+        const text = [
+            bio,
+            adjectiveSentence,
+            topicSentence,
+            topics,
+            directions,
+            examples,
+            system,
+        ]
+            .filter(Boolean)
+            .join("\n\n");
+        return {
+            values,
+            data: {
+                bio: data.bio,
+                adjective: data.adjective,
+                topic: data.topic,
+                topics: data.topics,
+                character: data.character,
+                directions: data.directions,
+                examples: data.examples,
+                system: data.system,
+            },
+            text,
+        };
+    },
+};

package/packages/typescript/src/features/basic-capabilities/providers/choice.d.ts

@@ -0,0 +1,11 @@
+import type { Provider } from "../../../types/index.ts";
+/**
+ * Choice provider function that retrieves all pending tasks with options for a specific room
+ *
+ * @param {IAgentRuntime} runtime - The runtime object for the agent
+ * @param {Memory} message - The message memory object
+ * @returns {Promise<ProviderResult>} A promise that resolves with the provider result containing the pending tasks with options
+ */
+export declare const choiceProvider: Provider;
+export default choiceProvider;
+//# sourceMappingURL=choice.d.ts.map

package/packages/typescript/src/features/basic-capabilities/providers/choice.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"choice.d.ts","sourceRoot":"","sources":["../../../../../../../../typescript/src/features/basic-capabilities/providers/choice.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAGX,QAAQ,EAGR,MAAM,yBAAyB,CAAC;AAuBjC;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,EAAE,QAyF5B,CAAC;AAEF,eAAe,cAAc,CAAC"}

package/packages/typescript/src/features/basic-capabilities/providers/choice.js

@@ -0,0 +1,86 @@
+import { requireProviderSpec } from "../../../generated/spec-helpers.js";
+// Get text content from centralized specs
+const spec = requireProviderSpec("CHOICE");
+/**
+ * Choice provider function that retrieves all pending tasks with options for a specific room
+ *
+ * @param {IAgentRuntime} runtime - The runtime object for the agent
+ * @param {Memory} message - The message memory object
+ * @returns {Promise<ProviderResult>} A promise that resolves with the provider result containing the pending tasks with options
+ */
+export const choiceProvider = {
+    name: spec.name,
+    description: spec.description,
+    get: async (runtime, message, _state) => {
+        // Get all pending tasks for this room with options
+        const pendingTasks = await runtime.getTasks({
+            roomId: message.roomId,
+            tags: ["AWAITING_CHOICE"],
+            agentIds: [runtime.agentId],
+        });
+        if (!pendingTasks || pendingTasks.length === 0) {
+            return {
+                data: {
+                    tasks: [],
+                },
+                values: {
+                    tasks: "No pending choices for the moment.",
+                },
+                text: "No pending choices for the moment.",
+            };
+        }
+        // Filter tasks that have options
+        const tasksWithOptions = pendingTasks.filter((task) => task.metadata?.options);
+        if (tasksWithOptions.length === 0) {
+            return {
+                data: {
+                    tasks: [],
+                },
+                values: {
+                    tasks: "No pending choices for the moment.",
+                },
+                text: "No pending choices for the moment.",
+            };
+        }
+        // Format tasks into a readable list
+        let output = "# Pending Tasks\n\n";
+        output += "The following tasks are awaiting your selection:\n\n";
+        tasksWithOptions.forEach((task, index) => {
+            output += `${index + 1}. **${task.name}**\n`;
+            if (task.description) {
+                output += `   ${task.description}\n`;
+            }
+            // List available options
+            if (task.metadata?.options) {
+                output += "   Options:\n";
+                // Handle both string[] and OptionObject[] formats
+                const options = task.metadata.options;
+                options.forEach((option) => {
+                    if (typeof option === "string") {
+                        // Handle string option
+                        const description = task.metadata?.options?.find((o) => o.name === option)
+                            ?.description || "";
+                        output += `   - \`${option}\` ${description ? `- ${description}` : ""}\n`;
+                    }
+                    else {
+                        // Handle option object
+                        output += `   - \`${option.name}\` ${option.description ? `- ${option.description}` : ""}\n`;
+                    }
+                });
+            }
+            output += "\n";
+        });
+        output +=
+            "To select an option, reply with the option name (e.g., 'post' or 'cancel').\n";
+        return {
+            data: {
+                tasks: tasksWithOptions,
+            },
+            values: {
+                tasks: output,
+            },
+            text: output,
+        };
+    },
+};
+export default choiceProvider;

package/packages/typescript/src/features/basic-capabilities/providers/contextBench.d.ts

@@ -0,0 +1,12 @@
+import type { Provider } from "../../../types/index.ts";
+/**
+ * Benchmark context provider.
+ *
+ * If a benchmark harness attaches context to the inbound message metadata (as `benchmarkContext`),
+ * this provider surfaces it to the model and sets `benchmark_has_context=true` in state.values.
+ *
+ * Python's message service uses `benchmark_has_context` to force REPLY/action execution so the
+ * full Provider -> Model -> Action -> Evaluator loop is exercised during benchmarks.
+ */
+export declare const contextBenchProvider: Provider;
+//# sourceMappingURL=contextBench.d.ts.map

package/packages/typescript/src/features/basic-capabilities/providers/contextBench.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contextBench.d.ts","sourceRoot":"","sources":["../../../../../../../../typescript/src/features/basic-capabilities/providers/contextBench.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAGX,QAAQ,EAER,MAAM,yBAAyB,CAAC;AAkBjC;;;;;;;;GAQG;AACH,eAAO,MAAM,oBAAoB,EAAE,QAiClC,CAAC"}

package/packages/typescript/src/features/basic-capabilities/providers/contextBench.js

@@ -0,0 +1,50 @@
+import { requireProviderSpec } from "../../../generated/spec-helpers.js";
+// Get text content from centralized specs
+const spec = requireProviderSpec("CONTEXT_BENCH");
+function hasBenchmarkContext(meta) {
+    return (typeof meta === "object" &&
+        meta !== null &&
+        "benchmarkContext" in meta &&
+        (typeof meta.benchmarkContext ===
+            "string" ||
+            meta.benchmarkContext === undefined));
+}
+/**
+ * Benchmark context provider.
+ *
+ * If a benchmark harness attaches context to the inbound message metadata (as `benchmarkContext`),
+ * this provider surfaces it to the model and sets `benchmark_has_context=true` in state.values.
+ *
+ * Python's message service uses `benchmark_has_context` to force REPLY/action execution so the
+ * full Provider -> Model -> Action -> Evaluator loop is exercised during benchmarks.
+ */
+export const contextBenchProvider = {
+    name: spec.name,
+    description: spec.description,
+    position: spec.position ?? 5,
+    get: async (_runtime, message, _state) => {
+        const meta = message.metadata;
+        const benchmarkContext = hasBenchmarkContext(meta)
+            ? meta.benchmarkContext
+            : undefined;
+        if (typeof benchmarkContext !== "string" ||
+            benchmarkContext.trim() === "") {
+            return {
+                text: "",
+                values: {
+                    benchmark_has_context: false,
+                },
+                data: {},
+            };
+        }
+        return {
+            text: `# Benchmark Context\n${benchmarkContext.trim()}`,
+            values: {
+                benchmark_has_context: true,
+            },
+            data: {
+                benchmarkContext: benchmarkContext.trim(),
+            },
+        };
+    },
+};

package/packages/typescript/src/features/basic-capabilities/providers/currentTime.d.ts

@@ -0,0 +1,11 @@
+import type { Provider } from "../../../types/index.ts";
+/**
+ * Current time provider function that retrieves the current date and time
+ * in various formats for use in time-based operations or responses.
+ *
+ * @param _runtime - The runtime environment of the bot agent.
+ * @param _message - The memory object containing message data.
+ * @returns An object containing the current date and time data in various formats.
+ */
+export declare const currentTimeProvider: Provider;
+//# sourceMappingURL=currentTime.d.ts.map

package/packages/typescript/src/features/basic-capabilities/providers/currentTime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"currentTime.d.ts","sourceRoot":"","sources":["../../../../../../../../typescript/src/features/basic-capabilities/providers/currentTime.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAGX,QAAQ,EAER,MAAM,yBAAyB,CAAC;AAKjC;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB,EAAE,QAiDjC,CAAC"}

package/packages/typescript/src/features/basic-capabilities/providers/currentTime.js

@@ -0,0 +1,56 @@
+import { requireProviderSpec } from "../../../generated/spec-helpers.js";
+// Get text content from centralized specs
+const spec = requireProviderSpec("CURRENT_TIME");
+/**
+ * Current time provider function that retrieves the current date and time
+ * in various formats for use in time-based operations or responses.
+ *
+ * @param _runtime - The runtime environment of the bot agent.
+ * @param _message - The memory object containing message data.
+ * @returns An object containing the current date and time data in various formats.
+ */
+export const currentTimeProvider = {
+    name: spec.name,
+    description: spec.description,
+    dynamic: spec.dynamic ?? true,
+    get: async (_runtime, _message, _state) => {
+        const now = new Date();
+        const isoTimestamp = now.toISOString();
+        const unixTimestamp = Math.floor(now.getTime() / 1000);
+        const options = {
+            timeZone: "UTC",
+            dateStyle: "full",
+            timeStyle: "long",
+        };
+        const humanReadable = new Intl.DateTimeFormat("en-US", options).format(now);
+        const dateOnly = now.toISOString().split("T")[0];
+        const timeOnly = now.toISOString().split("T")[1].split(".")[0];
+        const dayOfWeek = now.toLocaleDateString("en-US", {
+            weekday: "long",
+            timeZone: "UTC",
+        });
+        const contextText = `# Current Time
+- Date: ${dateOnly}
+- Time: ${timeOnly} UTC
+- Day: ${dayOfWeek}
+- Full: ${humanReadable}
+- ISO: ${isoTimestamp}`;
+        return {
+            text: contextText,
+            values: {
+                currentTime: isoTimestamp,
+                currentDate: dateOnly,
+                dayOfWeek: dayOfWeek,
+                unixTimestamp: unixTimestamp,
+            },
+            data: {
+                iso: isoTimestamp,
+                date: dateOnly,
+                time: timeOnly,
+                dayOfWeek: dayOfWeek,
+                humanReadable: humanReadable,
+                unixTimestamp: unixTimestamp,
+            },
+        };
+    },
+};

package/packages/typescript/src/features/basic-capabilities/providers/entities.d.ts

@@ -0,0 +1,7 @@
+import type { Provider } from "../../../types/index.ts";
+/**
+ * Provider for fetching entities related to the current conversation.
+ * @type { Provider }
+ */
+export declare const entitiesProvider: Provider;
+//# sourceMappingURL=entities.d.ts.map

package/packages/typescript/src/features/basic-capabilities/providers/entities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entities.d.ts","sourceRoot":"","sources":["../../../../../../../../typescript/src/features/basic-capabilities/providers/entities.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAIX,QAAQ,EACR,MAAM,yBAAyB,CAAC;AAMjC;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,QAkC9B,CAAC"}

package/packages/typescript/src/features/basic-capabilities/providers/entities.js

@@ -0,0 +1,39 @@
+import { formatEntities, getEntityDetails } from "../../../entities.js";
+import { requireProviderSpec } from "../../../generated/spec-helpers.js";
+import { addHeader } from "../../../utils.js";
+// Get text content from centralized specs
+const spec = requireProviderSpec("ENTITIES");
+/**
+ * Provider for fetching entities related to the current conversation.
+ * @type { Provider }
+ */
+export const entitiesProvider = {
+    name: spec.name,
+    description: spec.description,
+    dynamic: spec.dynamic ?? true,
+    get: async (runtime, message) => {
+        const { roomId, entityId } = message;
+        // Get entities details
+        const entitiesData = await getEntityDetails({ runtime, roomId });
+        // Format entities for display
+        const formattedEntities = formatEntities({ entities: entitiesData ?? [] });
+        // Find sender name
+        const senderName = entitiesData?.find((entity) => entity.id === entityId)?.names[0];
+        // Create formatted text with header
+        const entities = formattedEntities && formattedEntities.length > 0
+            ? addHeader("# People in the Room", formattedEntities)
+            : "";
+        const data = {
+            entitiesData,
+            senderName,
+        };
+        const values = {
+            entities,
+        };
+        return {
+            data,
+            values,
+            text: entities,
+        };
+    },
+};

package/packages/typescript/src/features/basic-capabilities/providers/evaluators.d.ts

@@ -0,0 +1,27 @@
+import type { Evaluator, Provider } from "../../../types/index.ts";
+/**
+ * Formats the names of evaluators into a comma-separated list, each enclosed in single quotes.
+ * @param evaluators - An array of evaluator objects.
+ * @returns A string that concatenates the names of all evaluators, each enclosed in single quotes and separated by commas.
+ */
+/**
+ * Formats the names of the evaluators in the provided array.
+ *
+ * @param {Evaluator[]} evaluators - Array of evaluators.
+ * @returns {string} - Formatted string of evaluator names.
+ */
+export declare function formatEvaluatorNames(evaluators: Evaluator[]): string;
+/**
+ * Formats evaluator examples into a readable string, replacing placeholders with generated names.
+ * @param evaluators - An array of evaluator objects, each containing examples to format.
+ * @returns A string that presents each evaluator example in a structured format, including context, messages, and outcomes, with placeholders replaced by generated names.
+ */
+export declare function formatEvaluatorExamples(evaluators: Evaluator[]): string;
+/**
+ * Formats evaluator details into a string, including both the name and description of each evaluator.
+ * @param evaluators - An array of evaluator objects.
+ * @returns A string that concatenates the name and description of each evaluator, separated by a colon and a newline character.
+ */
+export declare function formatEvaluators(evaluators: Evaluator[]): string;
+export declare const evaluatorsProvider: Provider;
+//# sourceMappingURL=evaluators.d.ts.map

package/packages/typescript/src/features/basic-capabilities/providers/evaluators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluators.d.ts","sourceRoot":"","sources":["../../../../../../../../typescript/src/features/basic-capabilities/providers/evaluators.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAEX,SAAS,EAGT,QAAQ,EAER,MAAM,yBAAyB,CAAC;AAOjC;;;;GAIG;AACH;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,SAAS,EAAE,UAI3D;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,SAAS,EAAE,UAsC9D;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,SAAS,EAAE,UAMvD;AAED,eAAO,MAAM,kBAAkB,EAAE,QAwDhC,CAAC"}

package/packages/typescript/src/features/basic-capabilities/providers/evaluators.js

@@ -0,0 +1,107 @@
+import { requireProviderSpec } from "../../../generated/spec-helpers.js";
+import { pickRandomExampleName } from "../../../utils/example-names.js";
+import { addHeader } from "../../../utils.js";
+// Get text content from centralized specs
+const spec = requireProviderSpec("EVALUATORS");
+/**
+ * Formats the names of evaluators into a comma-separated list, each enclosed in single quotes.
+ * @param evaluators - An array of evaluator objects.
+ * @returns A string that concatenates the names of all evaluators, each enclosed in single quotes and separated by commas.
+ */
+/**
+ * Formats the names of the evaluators in the provided array.
+ *
+ * @param {Evaluator[]} evaluators - Array of evaluators.
+ * @returns {string} - Formatted string of evaluator names.
+ */
+export function formatEvaluatorNames(evaluators) {
+    return evaluators
+        .map((evaluator) => `'${evaluator.name}'`)
+        .join(",\n");
+}
+/**
+ * Formats evaluator examples into a readable string, replacing placeholders with generated names.
+ * @param evaluators - An array of evaluator objects, each containing examples to format.
+ * @returns A string that presents each evaluator example in a structured format, including context, messages, and outcomes, with placeholders replaced by generated names.
+ */
+export function formatEvaluatorExamples(evaluators) {
+    return evaluators
+        .map((evaluator) => {
+        return evaluator.examples
+            .map((example) => {
+            const exampleNames = Array.from({ length: 5 }, () => pickRandomExampleName());
+            let formattedPrompt = example.prompt;
+            let formattedOutcome = example.outcome;
+            exampleNames.forEach((name, index) => {
+                const placeholder = `{{name${index + 1}}}`;
+                formattedPrompt = formattedPrompt.replaceAll(placeholder, name);
+                formattedOutcome = formattedOutcome.replaceAll(placeholder, name);
+            });
+            const formattedMessages = example.messages
+                .map((message) => {
+                let messageString = `${message.name}: ${message.content.text}`;
+                exampleNames.forEach((name, index) => {
+                    const placeholder = `{{name${index + 1}}}`;
+                    messageString = messageString.replaceAll(placeholder, name);
+                });
+                const actionOrActions = message.content.action || message.content.actions?.join(", ");
+                return (messageString + (actionOrActions ? ` (${actionOrActions})` : ""));
+            })
+                .join("\n");
+            return `Prompt:\n${formattedPrompt}\n\nMessages:\n${formattedMessages}\n\nOutcome:\n${formattedOutcome}`;
+        })
+            .join("\n\n");
+    })
+        .join("\n\n");
+}
+/**
+ * Formats evaluator details into a string, including both the name and description of each evaluator.
+ * @param evaluators - An array of evaluator objects.
+ * @returns A string that concatenates the name and description of each evaluator, separated by a colon and a newline character.
+ */
+export function formatEvaluators(evaluators) {
+    return evaluators
+        .map((evaluator) => `'${evaluator.name}: ${evaluator.description}'`)
+        .join(",\n");
+}
+export const evaluatorsProvider = {
+    name: spec.name,
+    description: spec.description,
+    private: true,
+    get: async (runtime, message, state) => {
+        // Get evaluators that validate for this message
+        const evaluatorPromises = runtime.evaluators.map(async (evaluator) => {
+            const result = await evaluator.validate(runtime, message, state);
+            if (result) {
+                return evaluator;
+            }
+            return null;
+        });
+        // Wait for all validations
+        const resolvedEvaluators = await Promise.all(evaluatorPromises);
+        // Filter out null values
+        const evaluatorsData = resolvedEvaluators.filter(Boolean);
+        // Format evaluator-related texts
+        const evaluators = evaluatorsData.length > 0
+            ? addHeader("# Available Evaluators", formatEvaluators(evaluatorsData))
+            : "";
+        const evaluatorNames = evaluatorsData.length > 0 ? formatEvaluatorNames(evaluatorsData) : "";
+        const evaluatorExamples = evaluatorsData.length > 0
+            ? addHeader("# Evaluator Examples", formatEvaluatorExamples(evaluatorsData))
+            : "";
+        const values = {
+            evaluators,
+            evaluatorNames,
+            evaluatorExamples,
+        };
+        // Combine all text sections
+        const text = [evaluators, evaluatorExamples].filter(Boolean).join("\n\n");
+        return {
+            values,
+            data: {
+                evaluatorsData,
+            },
+            text,
+        };
+    },
+};

package/packages/typescript/src/features/basic-capabilities/providers/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Basic Providers
+ *
+ * Core providers included by default in the basic-capabilities plugin.
+ */
+export { actionStateProvider } from "./actionState.ts";
+export { actionsProvider } from "./actions.ts";
+export { attachmentsProvider } from "./attachments.ts";
+export { characterProvider } from "./character.ts";
+export { choiceProvider } from "./choice.ts";
+export { contextBenchProvider } from "./contextBench.ts";
+export { currentTimeProvider } from "./currentTime.ts";
+export { entitiesProvider } from "./entities.ts";
+export { evaluatorsProvider } from "./evaluators.ts";
+export { providersProvider } from "./providers.ts";
+export { recentMessagesProvider } from "./recentMessages.ts";
+export { timeProvider } from "./time.ts";
+export { uiContextProvider } from "./uiContext.ts";
+export { worldProvider } from "./world.ts";
+//# sourceMappingURL=index.d.ts.map

package/packages/typescript/src/features/basic-capabilities/providers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../../typescript/src/features/basic-capabilities/providers/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC"}