@langchain/classic 1.0.0-alpha.1

package/dist/experimental/chains/violation_of_expectations/violation_of_expectations_prompt.cjs

@@ -0,0 +1,52 @@
+const require_rolldown_runtime = require('../../../_virtual/rolldown_runtime.cjs');
+const __langchain_core_prompts = require_rolldown_runtime.__toESM(require("@langchain/core/prompts"));
+
+//#region src/experimental/chains/violation_of_expectations/violation_of_expectations_prompt.ts
+const PREDICT_NEXT_USER_MESSAGE_PROMPT = /* @__PURE__ */ __langchain_core_prompts.PromptTemplate.fromTemplate(`
+You have been tasked with coming up with insights and data-points based on a chat history between a human and an AI.
+Given the user's chat history provide the following:
+- Concise reasoning about the users internal mental state.
+- Your prediction on how they will respond to the AI's most recent message.
+- A concise list of any additional insights that would be useful to improve prediction.
+--------
+Chat History: {chat_history}`);
+const PREDICTION_VIOLATIONS_PROMPT = /* @__PURE__ */ __langchain_core_prompts.PromptTemplate.fromTemplate(`You have been given a prediction and an actual message from a human and AI conversation.
+Using the prediction, actual message, and additional user insights, generate the following:
+- How exactly was the original prediction violated? Which parts were wrong? State the exact differences.
+- If there were errors with the prediction, what were they and why?
+--------
+Predicted Output: {predicted_output}
+--------
+Actual Output: {actual_output}
+--------
+User Insights: {user_insights}
+--------
+`);
+const GENERATE_REVISED_PREDICTION_PROMPT = /* @__PURE__ */ __langchain_core_prompts.PromptTemplate.fromTemplate(`
+You have been tasked with revising a prediction on what a user might say in a chat conversation.
+--------
+Your previous prediction: {prediction}
+--------
+Ways in which your prediction was off: {explained_prediction_errors}
+--------
+Key insights to the user: {user_insights}
+--------
+Given the above, revise your prediction to be more accurate.
+Revised Prediction:`);
+const GENERATE_FACTS_PROMPT = /* @__PURE__ */ __langchain_core_prompts.PromptTemplate.fromTemplate(`
+Given a user message, an LLM generated prediction of what that message might be, and a list of violations which the prediction made compared to the actual message, generate a fact about the user, relevant to the users message.
+--------
+Prediction violations: {prediction_violations}
+--------
+Revised prediction: {prediction}
+--------
+Actual user message: {user_message}
+--------
+Relevant fact:`);
+
+//#endregion
+exports.GENERATE_FACTS_PROMPT = GENERATE_FACTS_PROMPT;
+exports.GENERATE_REVISED_PREDICTION_PROMPT = GENERATE_REVISED_PREDICTION_PROMPT;
+exports.PREDICTION_VIOLATIONS_PROMPT = PREDICTION_VIOLATIONS_PROMPT;
+exports.PREDICT_NEXT_USER_MESSAGE_PROMPT = PREDICT_NEXT_USER_MESSAGE_PROMPT;
+//# sourceMappingURL=violation_of_expectations_prompt.cjs.map

package/dist/experimental/chains/violation_of_expectations/violation_of_expectations_prompt.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"violation_of_expectations_prompt.cjs","names":["PromptTemplate"],"sources":["../../../../src/experimental/chains/violation_of_expectations/violation_of_expectations_prompt.ts"],"sourcesContent":["import { PromptTemplate } from \"@langchain/core/prompts\";\n\nexport const PREDICT_NEXT_USER_MESSAGE_PROMPT =\n  /* #__PURE__ */ PromptTemplate.fromTemplate(`\nYou have been tasked with coming up with insights and data-points based on a chat history between a human and an AI.\nGiven the user's chat history provide the following:\n- Concise reasoning about the users internal mental state.\n- Your prediction on how they will respond to the AI's most recent message.\n- A concise list of any additional insights that would be useful to improve prediction.\n--------\nChat History: {chat_history}`);\n\nexport const PREDICTION_VIOLATIONS_PROMPT =\n  /* #__PURE__ */ PromptTemplate.fromTemplate(`You have been given a prediction and an actual message from a human and AI conversation.\nUsing the prediction, actual message, and additional user insights, generate the following:\n- How exactly was the original prediction violated? Which parts were wrong? State the exact differences.\n- If there were errors with the prediction, what were they and why?\n--------\nPredicted Output: {predicted_output}\n--------\nActual Output: {actual_output}\n--------\nUser Insights: {user_insights}\n--------\n`);\n\nexport const GENERATE_REVISED_PREDICTION_PROMPT =\n  /* #__PURE__ */ PromptTemplate.fromTemplate(`\nYou have been tasked with revising a prediction on what a user might say in a chat conversation.\n--------\nYour previous prediction: {prediction}\n--------\nWays in which your prediction was off: {explained_prediction_errors}\n--------\nKey insights to the user: {user_insights}\n--------\nGiven the above, revise your prediction to be more accurate.\nRevised Prediction:`);\n\nexport const GENERATE_FACTS_PROMPT =\n  /* #__PURE__ */ PromptTemplate.fromTemplate(`\nGiven a user message, an LLM generated prediction of what that message might be, and a list of violations which the prediction made compared to the actual message, generate a fact about the user, relevant to the users message.\n--------\nPrediction violations: {prediction_violations}\n--------\nRevised prediction: {prediction}\n--------\nActual user message: {user_message}\n--------\nRelevant fact:`);\n"],"mappings":";;;;AAEA,MAAa,mDACKA,wCAAe,aAAa,CAAC;;;;;;;4BAOnB,CAAC,CAAC;AAE9B,MAAa,+CACKA,wCAAe,aAAa,CAAC;;;;;;;;;;;AAW/C,CAAC,CAAC;AAEF,MAAa,qDACKA,wCAAe,aAAa,CAAC;;;;;;;;;;mBAU5B,CAAC,CAAC;AAErB,MAAa,wCACKA,wCAAe,aAAa,CAAC;;;;;;;;;cASjC,CAAC,CAAC"}

package/dist/experimental/chains/violation_of_expectations/violation_of_expectations_prompt.js

@@ -0,0 +1,48 @@
+import { PromptTemplate } from "@langchain/core/prompts";
+
+//#region src/experimental/chains/violation_of_expectations/violation_of_expectations_prompt.ts
+const PREDICT_NEXT_USER_MESSAGE_PROMPT = /* @__PURE__ */ PromptTemplate.fromTemplate(`
+You have been tasked with coming up with insights and data-points based on a chat history between a human and an AI.
+Given the user's chat history provide the following:
+- Concise reasoning about the users internal mental state.
+- Your prediction on how they will respond to the AI's most recent message.
+- A concise list of any additional insights that would be useful to improve prediction.
+--------
+Chat History: {chat_history}`);
+const PREDICTION_VIOLATIONS_PROMPT = /* @__PURE__ */ PromptTemplate.fromTemplate(`You have been given a prediction and an actual message from a human and AI conversation.
+Using the prediction, actual message, and additional user insights, generate the following:
+- How exactly was the original prediction violated? Which parts were wrong? State the exact differences.
+- If there were errors with the prediction, what were they and why?
+--------
+Predicted Output: {predicted_output}
+--------
+Actual Output: {actual_output}
+--------
+User Insights: {user_insights}
+--------
+`);
+const GENERATE_REVISED_PREDICTION_PROMPT = /* @__PURE__ */ PromptTemplate.fromTemplate(`
+You have been tasked with revising a prediction on what a user might say in a chat conversation.
+--------
+Your previous prediction: {prediction}
+--------
+Ways in which your prediction was off: {explained_prediction_errors}
+--------
+Key insights to the user: {user_insights}
+--------
+Given the above, revise your prediction to be more accurate.
+Revised Prediction:`);
+const GENERATE_FACTS_PROMPT = /* @__PURE__ */ PromptTemplate.fromTemplate(`
+Given a user message, an LLM generated prediction of what that message might be, and a list of violations which the prediction made compared to the actual message, generate a fact about the user, relevant to the users message.
+--------
+Prediction violations: {prediction_violations}
+--------
+Revised prediction: {prediction}
+--------
+Actual user message: {user_message}
+--------
+Relevant fact:`);
+
+//#endregion
+export { GENERATE_FACTS_PROMPT, GENERATE_REVISED_PREDICTION_PROMPT, PREDICTION_VIOLATIONS_PROMPT, PREDICT_NEXT_USER_MESSAGE_PROMPT };
+//# sourceMappingURL=violation_of_expectations_prompt.js.map

package/dist/experimental/chains/violation_of_expectations/violation_of_expectations_prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"violation_of_expectations_prompt.js","names":[],"sources":["../../../../src/experimental/chains/violation_of_expectations/violation_of_expectations_prompt.ts"],"sourcesContent":["import { PromptTemplate } from \"@langchain/core/prompts\";\n\nexport const PREDICT_NEXT_USER_MESSAGE_PROMPT =\n  /* #__PURE__ */ PromptTemplate.fromTemplate(`\nYou have been tasked with coming up with insights and data-points based on a chat history between a human and an AI.\nGiven the user's chat history provide the following:\n- Concise reasoning about the users internal mental state.\n- Your prediction on how they will respond to the AI's most recent message.\n- A concise list of any additional insights that would be useful to improve prediction.\n--------\nChat History: {chat_history}`);\n\nexport const PREDICTION_VIOLATIONS_PROMPT =\n  /* #__PURE__ */ PromptTemplate.fromTemplate(`You have been given a prediction and an actual message from a human and AI conversation.\nUsing the prediction, actual message, and additional user insights, generate the following:\n- How exactly was the original prediction violated? Which parts were wrong? State the exact differences.\n- If there were errors with the prediction, what were they and why?\n--------\nPredicted Output: {predicted_output}\n--------\nActual Output: {actual_output}\n--------\nUser Insights: {user_insights}\n--------\n`);\n\nexport const GENERATE_REVISED_PREDICTION_PROMPT =\n  /* #__PURE__ */ PromptTemplate.fromTemplate(`\nYou have been tasked with revising a prediction on what a user might say in a chat conversation.\n--------\nYour previous prediction: {prediction}\n--------\nWays in which your prediction was off: {explained_prediction_errors}\n--------\nKey insights to the user: {user_insights}\n--------\nGiven the above, revise your prediction to be more accurate.\nRevised Prediction:`);\n\nexport const GENERATE_FACTS_PROMPT =\n  /* #__PURE__ */ PromptTemplate.fromTemplate(`\nGiven a user message, an LLM generated prediction of what that message might be, and a list of violations which the prediction made compared to the actual message, generate a fact about the user, relevant to the users message.\n--------\nPrediction violations: {prediction_violations}\n--------\nRevised prediction: {prediction}\n--------\nActual user message: {user_message}\n--------\nRelevant fact:`);\n"],"mappings":";;;AAEA,MAAa,mDACK,eAAe,aAAa,CAAC;;;;;;;4BAOnB,CAAC,CAAC;AAE9B,MAAa,+CACK,eAAe,aAAa,CAAC;;;;;;;;;;;AAW/C,CAAC,CAAC;AAEF,MAAa,qDACK,eAAe,aAAa,CAAC;;;;;;;;;;mBAU5B,CAAC,CAAC;AAErB,MAAa,wCACK,eAAe,aAAa,CAAC;;;;;;;;;cASjC,CAAC,CAAC"}

package/dist/experimental/generative_agents/generative_agent.cjs

@@ -0,0 +1,319 @@
+const require_rolldown_runtime = require('../../_virtual/rolldown_runtime.cjs');
+const require_base = require('../../chains/base.cjs');
+const require_llm_chain = require('../../chains/llm_chain.cjs');
+const __langchain_core_prompts = require_rolldown_runtime.__toESM(require("@langchain/core/prompts"));
+
+//#region src/experimental/generative_agents/generative_agent.ts
+/**
+* Implementation of a generative agent that can learn and form new memories over
+* time. It extends the BaseChain class, which is a generic
+* sequence of calls to components, including other chains.
+* @example
+* ```typescript
+* const tommie: GenerativeAgent = new GenerativeAgent(
+*   new OpenAI({ temperature: 0.9, maxTokens: 1500 }),
+*   new GenerativeAgentMemory(
+*     new ChatOpenAI({ model: "gpt-4o-mini" }),
+*     new TimeWeightedVectorStoreRetriever({
+*       vectorStore: new MemoryVectorStore(new OpenAIEmbeddings()),
+*       otherScoreKeys: ["importance"],
+*       k: 15,
+*     }),
+*     { reflectionThreshold: 8 },
+*   ),
+*   {
+*     name: "Tommie",
+*     age: 25,
+*     traits: "anxious, likes design, talkative",
+*     status: "looking for a job",
+*   },
+* );
+*
+* await tommie.addMemory(
+*   "Tommie remembers his dog, Bruno, from when he was a kid",
+*   new Date(),
+* );
+* const summary = await tommie.getSummary({ forceRefresh: true });
+* const response = await tommie.generateDialogueResponse(
+*   "USER says Hello Tommie, how are you today?",
+* );
+* ```
+*/
+var GenerativeAgent = class extends require_base.BaseChain {
+	static lc_name() {
+		return "GenerativeAgent";
+	}
+	name;
+	age;
+	traits;
+	status;
+	longTermMemory;
+	llm;
+	verbose;
+	summary;
+	summaryRefreshSeconds = 3600;
+	lastRefreshed;
+	_chainType() {
+		return "generative_agent_executor";
+	}
+	get inputKeys() {
+		return [
+			"observation",
+			"suffix",
+			"now"
+		];
+	}
+	get outputKeys() {
+		return ["output", "continue_dialogue"];
+	}
+	constructor(llm, longTermMemory, config) {
+		super();
+		this.llm = llm;
+		this.longTermMemory = longTermMemory;
+		this.name = config.name;
+		this.age = config.age;
+		this.traits = config.traits;
+		this.status = config.status;
+		this.verbose = config.verbose ?? this.verbose;
+		this.summary = "";
+		this.summaryRefreshSeconds = config.summaryRefreshSeconds ?? this.summaryRefreshSeconds;
+		this.lastRefreshed = /* @__PURE__ */ new Date();
+	}
+	/**
+	* Parses a newline-separated string into a list of strings.
+	* @param text The string to parse.
+	* @returns An array of strings parsed from the input text.
+	*/
+	parseList(text) {
+		const lines = text.trim().split("\n");
+		const result = lines.map((line) => line.replace(/^\s*\d+\.\s*/, "").trim());
+		return result;
+	}
+	/**
+	* Creates a new LLMChain with the given prompt and the agent's language
+	* model, verbosity, output key, and memory.
+	* @param prompt The prompt to use for the LLMChain.
+	* @returns A new LLMChain instance.
+	*/
+	chain(prompt) {
+		const chain = new require_llm_chain.LLMChain({
+			llm: this.llm,
+			prompt,
+			verbose: this.verbose,
+			outputKey: "output",
+			memory: this.longTermMemory
+		});
+		return chain;
+	}
+	/**
+	* Extracts the observed entity from the given observation.
+	* @param observation The observation to extract the entity from.
+	* @param runManager Optional CallbackManagerForChainRun instance.
+	* @returns The extracted entity as a string.
+	*/
+	async getEntityFromObservations(observation, runManager) {
+		const prompt = __langchain_core_prompts.PromptTemplate.fromTemplate("What is the observed entity in the following observation? {observation}\nEntity=");
+		const result = await this.chain(prompt).call({ observation }, runManager?.getChild("entity_extractor"));
+		return result.output;
+	}
+	/**
+	* Extracts the action of the given entity from the given observation.
+	* @param observation The observation to extract the action from.
+	* @param entityName The name of the entity to extract the action for.
+	* @param runManager Optional CallbackManagerForChainRun instance.
+	* @returns The extracted action as a string.
+	*/
+	async getEntityAction(observation, entityName, runManager) {
+		const prompt = __langchain_core_prompts.PromptTemplate.fromTemplate("What is the {entity} doing in the following observation? {observation}\nThe {entity} is");
+		const result = await this.chain(prompt).call({
+			entity: entityName,
+			observation
+		}, runManager?.getChild("entity_action_extractor"));
+		const trimmedResult = result.output.trim();
+		return trimmedResult;
+	}
+	/**
+	* Summarizes memories that are most relevant to an observation.
+	* @param observation The observation to summarize related memories for.
+	* @param runManager Optional CallbackManagerForChainRun instance.
+	* @returns The summarized memories as a string.
+	*/
+	async summarizeRelatedMemories(observation, runManager) {
+		const prompt = __langchain_core_prompts.PromptTemplate.fromTemplate(`
+{q1}?
+Context from memory:
+{relevant_memories}
+Relevant context:`);
+		const entityName = await this.getEntityFromObservations(observation, runManager);
+		const entityAction = await this.getEntityAction(observation, entityName, runManager);
+		const q1 = `What is the relationship between ${this.name} and ${entityName}`;
+		const q2 = `${entityName} is ${entityAction}`;
+		const response = await this.chain(prompt).call({
+			q1,
+			queries: [q1, q2]
+		}, runManager?.getChild("entity_relationships"));
+		return response.output.trim();
+	}
+	async _call(values, runManager) {
+		const { observation, suffix, now } = values;
+		const prompt = __langchain_core_prompts.PromptTemplate.fromTemplate(`{agent_summary_description}
+It is {current_time}.
+{agent_name}'s status: {agent_status}
+Summary of relevant context from {agent_name}'s memory:
+{relevant_memories}
+Most recent observations: {most_recent_memories}
+Observation: {observation}\n\n${suffix}`);
+		const agentSummaryDescription = await this.getSummary({}, runManager);
+		const relevantMemoriesStr = await this.summarizeRelatedMemories(observation, runManager);
+		const currentTime = (now || /* @__PURE__ */ new Date()).toLocaleString("en-US", {
+			month: "long",
+			day: "numeric",
+			year: "numeric",
+			hour: "numeric",
+			minute: "numeric",
+			hour12: true
+		});
+		const chainInputs = {
+			agent_summary_description: agentSummaryDescription,
+			current_time: currentTime,
+			agent_name: this.name,
+			observation,
+			agent_status: this.status,
+			most_recent_memories: ""
+		};
+		chainInputs[this.longTermMemory.getRelevantMemoriesKey()] = relevantMemoriesStr;
+		const consumedTokens = await this.llm.getNumTokens(await prompt.format({ ...chainInputs }));
+		chainInputs[this.longTermMemory.getMostRecentMemoriesTokenKey()] = consumedTokens;
+		const response = await this.chain(prompt).call(chainInputs, runManager?.getChild("reaction_from_summary"));
+		const rawOutput = response.output;
+		let output = rawOutput;
+		let continue_dialogue = false;
+		if (rawOutput.includes("REACT:")) {
+			const reaction = this._cleanResponse(rawOutput.split("REACT:").pop());
+			await this.addMemory(`${this.name} observed ${observation} and reacted by ${reaction}`, now, {}, runManager?.getChild("memory"));
+			output = `${reaction}`;
+			continue_dialogue = false;
+		} else if (rawOutput.includes("SAY:")) {
+			const saidValue = this._cleanResponse(rawOutput.split("SAY:").pop());
+			await this.addMemory(`${this.name} observed ${observation} and said ${saidValue}`, now, {}, runManager?.getChild("memory"));
+			output = `${this.name} said ${saidValue}`;
+			continue_dialogue = true;
+		} else if (rawOutput.includes("GOODBYE:")) {
+			const farewell = this._cleanResponse(rawOutput.split("GOODBYE:").pop() ?? "");
+			await this.addMemory(`${this.name} observed ${observation} and said ${farewell}`, now, {}, runManager?.getChild("memory"));
+			output = `${this.name} said ${farewell}`;
+			continue_dialogue = false;
+		}
+		return {
+			output,
+			continue_dialogue
+		};
+	}
+	_cleanResponse(text) {
+		if (text === void 0) return "";
+		const regex = /* @__PURE__ */ new RegExp(`^${this.name} `);
+		return text.replace(regex, "").trim();
+	}
+	/**
+	* Generates a reaction to the given observation.
+	* @param observation The observation to generate a reaction for.
+	* @param now Optional current date.
+	* @returns A boolean indicating whether to continue the dialogue and the output string.
+	*/
+	async generateReaction(observation, now) {
+		const callToActionTemplate = "Should {agent_name} react to the observation, and if so, what would be an appropriate reaction? Respond in one line. If the action is to engage in dialogue, write:\nSAY: \"what to say\" \notherwise, write:\nREACT: {agent_name}'s reaction (if anything). \nEither do nothing, react, or say something but not both.\n\n";
+		const { output, continue_dialogue } = await this.call({
+			observation,
+			suffix: callToActionTemplate,
+			now
+		});
+		return [continue_dialogue, output];
+	}
+	/**
+	* Generates a dialogue response to the given observation.
+	* @param observation The observation to generate a dialogue response for.
+	* @param now Optional current date.
+	* @returns A boolean indicating whether to continue the dialogue and the output string.
+	*/
+	async generateDialogueResponse(observation, now) {
+		const callToActionTemplate = `What would ${this.name} say? To end the conversation, write: GOODBYE: "what to say". Otherwise to continue the conversation, write: SAY: "what to say next"\n\n`;
+		const { output, continue_dialogue } = await this.call({
+			observation,
+			suffix: callToActionTemplate,
+			now
+		});
+		return [continue_dialogue, output];
+	}
+	/**
+	* Gets the agent's summary, which includes the agent's name, age, traits,
+	* and a summary of the agent's core characteristics. The summary is
+	* updated periodically through probing the agent's memories.
+	* @param config Optional configuration object with current date and a boolean to force refresh.
+	* @param runManager Optional CallbackManagerForChainRun instance.
+	* @returns The agent's summary as a string.
+	*/
+	async getSummary(config, runManager) {
+		const { now = /* @__PURE__ */ new Date(), forceRefresh = false } = config ?? {};
+		const sinceRefresh = Math.floor((now.getTime() - this.lastRefreshed.getTime()) / 1e3);
+		if (!this.summary || sinceRefresh >= this.summaryRefreshSeconds || forceRefresh) {
+			this.summary = await this.computeAgentSummary(runManager);
+			this.lastRefreshed = now;
+		}
+		let age;
+		if (this.age) age = this.age;
+		else age = "N/A";
+		return `Name: ${this.name} (age: ${age})
+Innate traits: ${this.traits}
+${this.summary}`;
+	}
+	/**
+	* Computes the agent's summary by summarizing the agent's core
+	* characteristics given the agent's relevant memories.
+	* @param runManager Optional CallbackManagerForChainRun instance.
+	* @returns The computed summary as a string.
+	*/
+	async computeAgentSummary(runManager) {
+		const prompt = __langchain_core_prompts.PromptTemplate.fromTemplate("How would you summarize {name}'s core characteristics given the following statements:\n----------{relevant_memories}----------Do not embellish.\n\nSummary: ");
+		const result = await this.chain(prompt).call({
+			name: this.name,
+			queries: [`${this.name}'s core characteristics`]
+		}, runManager?.getChild("compute_agent_summary"));
+		return result.output.trim();
+	}
+	/**
+	* Returns a full header of the agent's status, summary, and current time.
+	* @param config Optional configuration object with current date and a boolean to force refresh.
+	* @returns The full header as a string.
+	*/
+	getFullHeader(config = {}) {
+		const { now = /* @__PURE__ */ new Date(), forceRefresh = false } = config;
+		const summary = this.getSummary({
+			now,
+			forceRefresh
+		});
+		const currentTimeString = now.toLocaleString("en-US", {
+			month: "long",
+			day: "numeric",
+			year: "numeric",
+			hour: "numeric",
+			minute: "numeric",
+			hour12: true
+		});
+		return `${summary}\nIt is ${currentTimeString}.\n${this.name}'s status: ${this.status}`;
+	}
+	/**
+	* Adds a memory to the agent's long-term memory.
+	* @param memoryContent The content of the memory to add.
+	* @param now Optional current date.
+	* @param metadata Optional metadata for the memory.
+	* @param callbacks Optional Callbacks instance.
+	* @returns The result of adding the memory to the agent's long-term memory.
+	*/
+	async addMemory(memoryContent, now, metadata, callbacks) {
+		return this.longTermMemory.addMemory(memoryContent, now, metadata, callbacks);
+	}
+};
+
+//#endregion
+exports.GenerativeAgent = GenerativeAgent;
+//# sourceMappingURL=generative_agent.cjs.map

package/dist/experimental/generative_agents/generative_agent.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"generative_agent.cjs","names":["BaseChain","llm: BaseLanguageModelInterface","longTermMemory: GenerativeAgentMemory","config: GenerativeAgentConfig","text: string","lines: string[]","result: string[]","line: string","prompt: PromptTemplate","LLMChain","observation: string","runManager?: CallbackManagerForChainRun","PromptTemplate","entityName: string","values: ChainValues","chainInputs: ChainValues","text: string | undefined","now?: Date","callToActionTemplate: string","config?: {\n      now?: Date;\n      forceRefresh?: boolean;\n    }","config: {\n      now?: Date;\n      forceRefresh?: boolean;\n    }","memoryContent: string","metadata?: Record<string, unknown>","callbacks?: Callbacks"],"sources":["../../../src/experimental/generative_agents/generative_agent.ts"],"sourcesContent":["import type { BaseLanguageModelInterface } from \"@langchain/core/language_models/base\";\nimport { PromptTemplate } from \"@langchain/core/prompts\";\nimport { ChainValues } from \"@langchain/core/utils/types\";\nimport {\n  CallbackManagerForChainRun,\n  Callbacks,\n} from \"@langchain/core/callbacks/manager\";\nimport { LLMChain } from \"../../chains/llm_chain.js\";\nimport { GenerativeAgentMemory } from \"./generative_agent_memory.js\";\nimport { BaseChain } from \"../../chains/base.js\";\n\n/**\n * Configuration for the GenerativeAgent class. Defines the character's\n * name, optional age, permanent traits, status, verbosity, and summary\n * refresh seconds.\n */\nexport type GenerativeAgentConfig = {\n  name: string;\n  age?: number;\n  traits: string;\n  status: string;\n  verbose?: boolean;\n  summaryRefreshSeconds?: number;\n  // dailySummaries?: string[];\n};\n\n/**\n * Implementation of a generative agent that can learn and form new memories over\n * time. It extends the BaseChain class, which is a generic\n * sequence of calls to components, including other chains.\n * @example\n * ```typescript\n * const tommie: GenerativeAgent = new GenerativeAgent(\n *   new OpenAI({ temperature: 0.9, maxTokens: 1500 }),\n *   new GenerativeAgentMemory(\n *     new ChatOpenAI({ model: \"gpt-4o-mini\" }),\n *     new TimeWeightedVectorStoreRetriever({\n *       vectorStore: new MemoryVectorStore(new OpenAIEmbeddings()),\n *       otherScoreKeys: [\"importance\"],\n *       k: 15,\n *     }),\n *     { reflectionThreshold: 8 },\n *   ),\n *   {\n *     name: \"Tommie\",\n *     age: 25,\n *     traits: \"anxious, likes design, talkative\",\n *     status: \"looking for a job\",\n *   },\n * );\n *\n * await tommie.addMemory(\n *   \"Tommie remembers his dog, Bruno, from when he was a kid\",\n *   new Date(),\n * );\n * const summary = await tommie.getSummary({ forceRefresh: true });\n * const response = await tommie.generateDialogueResponse(\n *   \"USER says Hello Tommie, how are you today?\",\n * );\n * ```\n */\nexport class GenerativeAgent extends BaseChain {\n  static lc_name() {\n    return \"GenerativeAgent\";\n  }\n\n  // a character with memory and innate characterisitics\n  name: string; // the character's name\n\n  age?: number; // the optional age of the character\n\n  traits: string; // permanent traits to ascribe to the character\n\n  status: string; // the traits of the character you wish not to change\n\n  longTermMemory: GenerativeAgentMemory;\n\n  llm: BaseLanguageModelInterface; // the underlying language model\n\n  verbose: boolean; // false\n\n  private summary: string; // stateful self-summary generated via reflection on the character's memory.\n\n  private summaryRefreshSeconds = 3600;\n\n  private lastRefreshed: Date; // the last time the character's summary was regenerated\n\n  // TODO: Add support for daily summaries\n  // private dailySummaries: string[] = []; // summary of the events in the plan that the agent took.\n\n  _chainType(): string {\n    return \"generative_agent_executor\";\n  }\n\n  get inputKeys(): string[] {\n    return [\"observation\", \"suffix\", \"now\"];\n  }\n\n  get outputKeys(): string[] {\n    return [\"output\", \"continue_dialogue\"];\n  }\n\n  constructor(\n    llm: BaseLanguageModelInterface,\n    longTermMemory: GenerativeAgentMemory,\n    config: GenerativeAgentConfig\n  ) {\n    super();\n    this.llm = llm;\n    this.longTermMemory = longTermMemory;\n    this.name = config.name;\n    this.age = config.age;\n    this.traits = config.traits;\n    this.status = config.status;\n    this.verbose = config.verbose ?? this.verbose;\n    this.summary = \"\";\n    this.summaryRefreshSeconds =\n      config.summaryRefreshSeconds ?? this.summaryRefreshSeconds;\n    this.lastRefreshed = new Date();\n    // this.dailySummaries = config.dailySummaries ?? this.dailySummaries;\n  }\n\n  // LLM methods\n  /**\n   * Parses a newline-separated string into a list of strings.\n   * @param text The string to parse.\n   * @returns An array of strings parsed from the input text.\n   */\n  parseList(text: string): string[] {\n    // parse a newline-seperated string into a list of strings\n    const lines: string[] = text.trim().split(\"\\n\");\n    const result: string[] = lines.map((line: string) =>\n      line.replace(/^\\s*\\d+\\.\\s*/, \"\").trim()\n    );\n    return result;\n  }\n\n  /**\n   * Creates a new LLMChain with the given prompt and the agent's language\n   * model, verbosity, output key, and memory.\n   * @param prompt The prompt to use for the LLMChain.\n   * @returns A new LLMChain instance.\n   */\n  chain(prompt: PromptTemplate): LLMChain {\n    const chain = new LLMChain({\n      llm: this.llm,\n      prompt,\n      verbose: this.verbose,\n      outputKey: \"output\", // new\n      memory: this.longTermMemory,\n    });\n    return chain;\n  }\n\n  /**\n   * Extracts the observed entity from the given observation.\n   * @param observation The observation to extract the entity from.\n   * @param runManager Optional CallbackManagerForChainRun instance.\n   * @returns The extracted entity as a string.\n   */\n  async getEntityFromObservations(\n    observation: string,\n    runManager?: CallbackManagerForChainRun\n  ): Promise<string> {\n    const prompt = PromptTemplate.fromTemplate(\n      \"What is the observed entity in the following observation? {observation}\" +\n        \"\\nEntity=\"\n    );\n\n    const result = await this.chain(prompt).call(\n      {\n        observation,\n      },\n      runManager?.getChild(\"entity_extractor\")\n    );\n\n    return result.output;\n  }\n\n  /**\n   * Extracts the action of the given entity from the given observation.\n   * @param observation The observation to extract the action from.\n   * @param entityName The name of the entity to extract the action for.\n   * @param runManager Optional CallbackManagerForChainRun instance.\n   * @returns The extracted action as a string.\n   */\n  async getEntityAction(\n    observation: string,\n    entityName: string,\n    runManager?: CallbackManagerForChainRun\n  ): Promise<string> {\n    const prompt = PromptTemplate.fromTemplate(\n      \"What is the {entity} doing in the following observation? {observation}\" +\n        \"\\nThe {entity} is\"\n    );\n\n    const result = await this.chain(prompt).call(\n      {\n        entity: entityName,\n        observation,\n      },\n      runManager?.getChild(\"entity_action_extractor\")\n    );\n    const trimmedResult = result.output.trim();\n    return trimmedResult;\n  }\n\n  /**\n   * Summarizes memories that are most relevant to an observation.\n   * @param observation The observation to summarize related memories for.\n   * @param runManager Optional CallbackManagerForChainRun instance.\n   * @returns The summarized memories as a string.\n   */\n  async summarizeRelatedMemories(\n    observation: string,\n    runManager?: CallbackManagerForChainRun\n  ): Promise<string> {\n    // summarize memories that are most relevant to an observation\n    const prompt = PromptTemplate.fromTemplate(\n      `\n{q1}?\nContext from memory:\n{relevant_memories}\nRelevant context:`\n    );\n    const entityName = await this.getEntityFromObservations(\n      observation,\n      runManager\n    );\n    const entityAction = await this.getEntityAction(\n      observation,\n      entityName,\n      runManager\n    );\n    const q1 = `What is the relationship between ${this.name} and ${entityName}`;\n    const q2 = `${entityName} is ${entityAction}`;\n    const response = await this.chain(prompt).call(\n      {\n        q1,\n        queries: [q1, q2],\n      },\n      runManager?.getChild(\"entity_relationships\")\n    );\n\n    return response.output.trim(); // added output\n  }\n\n  async _call(\n    values: ChainValues,\n    runManager?: CallbackManagerForChainRun\n  ): Promise<ChainValues> {\n    const { observation, suffix, now } = values;\n    // react to a given observation or dialogue act\n    const prompt = PromptTemplate.fromTemplate(\n      `{agent_summary_description}` +\n        `\\nIt is {current_time}.` +\n        `\\n{agent_name}'s status: {agent_status}` +\n        `\\nSummary of relevant context from {agent_name}'s memory:` +\n        \"\\n{relevant_memories}\" +\n        `\\nMost recent observations: {most_recent_memories}` +\n        `\\nObservation: {observation}` +\n        `\\n\\n${suffix}`\n    );\n\n    const agentSummaryDescription = await this.getSummary({}, runManager); // now = now in param\n    const relevantMemoriesStr = await this.summarizeRelatedMemories(\n      observation,\n      runManager\n    );\n    const currentTime = (now || new Date()).toLocaleString(\"en-US\", {\n      month: \"long\",\n      day: \"numeric\",\n      year: \"numeric\",\n      hour: \"numeric\",\n      minute: \"numeric\",\n      hour12: true,\n    });\n    const chainInputs: ChainValues = {\n      agent_summary_description: agentSummaryDescription,\n      current_time: currentTime,\n      agent_name: this.name,\n      observation,\n      agent_status: this.status,\n      most_recent_memories: \"\",\n    };\n\n    chainInputs[this.longTermMemory.getRelevantMemoriesKey()] =\n      relevantMemoriesStr;\n\n    const consumedTokens = await this.llm.getNumTokens(\n      await prompt.format({ ...chainInputs })\n    );\n\n    chainInputs[this.longTermMemory.getMostRecentMemoriesTokenKey()] =\n      consumedTokens;\n    const response = await this.chain(prompt).call(\n      chainInputs,\n      runManager?.getChild(\"reaction_from_summary\")\n    );\n\n    const rawOutput = response.output;\n    let output = rawOutput;\n    let continue_dialogue = false;\n\n    if (rawOutput.includes(\"REACT:\")) {\n      const reaction = this._cleanResponse(rawOutput.split(\"REACT:\").pop());\n      await this.addMemory(\n        `${this.name} observed ${observation} and reacted by ${reaction}`,\n        now,\n        {},\n        runManager?.getChild(\"memory\")\n      );\n      output = `${reaction}`;\n      continue_dialogue = false;\n    } else if (rawOutput.includes(\"SAY:\")) {\n      const saidValue = this._cleanResponse(rawOutput.split(\"SAY:\").pop());\n      await this.addMemory(\n        `${this.name} observed ${observation} and said ${saidValue}`,\n        now,\n        {},\n        runManager?.getChild(\"memory\")\n      );\n      output = `${this.name} said ${saidValue}`;\n      continue_dialogue = true;\n    } else if (rawOutput.includes(\"GOODBYE:\")) {\n      const farewell = this._cleanResponse(\n        rawOutput.split(\"GOODBYE:\").pop() ?? \"\"\n      );\n      await this.addMemory(\n        `${this.name} observed ${observation} and said ${farewell}`,\n        now,\n        {},\n        runManager?.getChild(\"memory\")\n      );\n      output = `${this.name} said ${farewell}`;\n      continue_dialogue = false;\n    }\n\n    return { output, continue_dialogue };\n  }\n\n  private _cleanResponse(text: string | undefined): string {\n    if (text === undefined) {\n      return \"\";\n    }\n    const regex = new RegExp(`^${this.name} `);\n    return text.replace(regex, \"\").trim();\n  }\n\n  /**\n   * Generates a reaction to the given observation.\n   * @param observation The observation to generate a reaction for.\n   * @param now Optional current date.\n   * @returns A boolean indicating whether to continue the dialogue and the output string.\n   */\n  async generateReaction(\n    observation: string,\n    now?: Date\n  ): Promise<[boolean, string]> {\n    const callToActionTemplate: string =\n      `Should {agent_name} react to the observation, and if so,` +\n      ` what would be an appropriate reaction? Respond in one line.` +\n      ` If the action is to engage in dialogue, write:\\nSAY: \"what to say\"` +\n      ` \\notherwise, write:\\nREACT: {agent_name}'s reaction (if anything).` +\n      ` \\nEither do nothing, react, or say something but not both.\\n\\n`;\n\n    const { output, continue_dialogue } = await this.call({\n      observation,\n      suffix: callToActionTemplate,\n      now,\n    });\n    return [continue_dialogue, output];\n  }\n\n  /**\n   * Generates a dialogue response to the given observation.\n   * @param observation The observation to generate a dialogue response for.\n   * @param now Optional current date.\n   * @returns A boolean indicating whether to continue the dialogue and the output string.\n   */\n  async generateDialogueResponse(\n    observation: string,\n    now?: Date\n  ): Promise<[boolean, string]> {\n    const callToActionTemplate = `What would ${this.name} say? To end the conversation, write: GOODBYE: \"what to say\". Otherwise to continue the conversation, write: SAY: \"what to say next\"\\n\\n`;\n    const { output, continue_dialogue } = await this.call({\n      observation,\n      suffix: callToActionTemplate,\n      now,\n    });\n    return [continue_dialogue, output];\n  }\n\n  // Agent stateful' summary methods\n  // Each dialog or response prompt includes a header\n  // summarizing the agent's self-description. This is\n  // updated periodically through probing it's memories\n  /**\n   * Gets the agent's summary, which includes the agent's name, age, traits,\n   * and a summary of the agent's core characteristics. The summary is\n   * updated periodically through probing the agent's memories.\n   * @param config Optional configuration object with current date and a boolean to force refresh.\n   * @param runManager Optional CallbackManagerForChainRun instance.\n   * @returns The agent's summary as a string.\n   */\n  async getSummary(\n    config?: {\n      now?: Date;\n      forceRefresh?: boolean;\n    },\n    runManager?: CallbackManagerForChainRun\n  ): Promise<string> {\n    const { now = new Date(), forceRefresh = false } = config ?? {};\n\n    const sinceRefresh = Math.floor(\n      (now.getTime() - this.lastRefreshed.getTime()) / 1000\n    );\n\n    if (\n      !this.summary ||\n      sinceRefresh >= this.summaryRefreshSeconds ||\n      forceRefresh\n    ) {\n      this.summary = await this.computeAgentSummary(runManager);\n      this.lastRefreshed = now;\n    }\n\n    let age;\n    if (this.age) {\n      age = this.age;\n    } else {\n      age = \"N/A\";\n    }\n\n    return `Name: ${this.name} (age: ${age})\nInnate traits: ${this.traits}\n${this.summary}`;\n  }\n\n  /**\n   * Computes the agent's summary by summarizing the agent's core\n   * characteristics given the agent's relevant memories.\n   * @param runManager Optional CallbackManagerForChainRun instance.\n   * @returns The computed summary as a string.\n   */\n  async computeAgentSummary(\n    runManager?: CallbackManagerForChainRun\n  ): Promise<string> {\n    const prompt = PromptTemplate.fromTemplate(\n      \"How would you summarize {name}'s core characteristics given the following statements:\\n\" +\n        \"----------\" +\n        \"{relevant_memories}\" +\n        \"----------\" +\n        \"Do not embellish.\" +\n        \"\\n\\nSummary: \"\n    );\n    // the agent seeks to think about their core characterisitics\n    const result = await this.chain(prompt).call(\n      {\n        name: this.name,\n        queries: [`${this.name}'s core characteristics`],\n      },\n      runManager?.getChild(\"compute_agent_summary\")\n    );\n    return result.output.trim();\n  }\n\n  /**\n   * Returns a full header of the agent's status, summary, and current time.\n   * @param config Optional configuration object with current date and a boolean to force refresh.\n   * @returns The full header as a string.\n   */\n  getFullHeader(\n    config: {\n      now?: Date;\n      forceRefresh?: boolean;\n    } = {}\n  ): string {\n    const { now = new Date(), forceRefresh = false } = config;\n    // return a full header of the agent's status, summary, and current time.\n    const summary = this.getSummary({ now, forceRefresh });\n    const currentTimeString = now.toLocaleString(\"en-US\", {\n      month: \"long\",\n      day: \"numeric\",\n      year: \"numeric\",\n      hour: \"numeric\",\n      minute: \"numeric\",\n      hour12: true,\n    });\n    return `${summary}\\nIt is ${currentTimeString}.\\n${this.name}'s status: ${this.status}`;\n  }\n\n  /**\n   * Adds a memory to the agent's long-term memory.\n   * @param memoryContent The content of the memory to add.\n   * @param now Optional current date.\n   * @param metadata Optional metadata for the memory.\n   * @param callbacks Optional Callbacks instance.\n   * @returns The result of adding the memory to the agent's long-term memory.\n   */\n  async addMemory(\n    memoryContent: string,\n    now?: Date,\n    metadata?: Record<string, unknown>,\n    callbacks?: Callbacks\n  ) {\n    return this.longTermMemory.addMemory(\n      memoryContent,\n      now,\n      metadata,\n      callbacks\n    );\n  }\n}\n"],"mappings":"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"}

package/dist/experimental/generative_agents/generative_agent.d.cts

@@ -0,0 +1,174 @@
+import { BaseChain } from "../../chains/base.cjs";
+import { LLMChain } from "../../chains/llm_chain.cjs";
+import { GenerativeAgentMemory } from "./generative_agent_memory.cjs";
+import { ChainValues } from "@langchain/core/utils/types";
+import { PromptTemplate } from "@langchain/core/prompts";
+import { BaseLanguageModelInterface } from "@langchain/core/language_models/base";
+import { CallbackManagerForChainRun, Callbacks } from "@langchain/core/callbacks/manager";
+
+//#region src/experimental/generative_agents/generative_agent.d.ts
+
+/**
+ * Configuration for the GenerativeAgent class. Defines the character's
+ * name, optional age, permanent traits, status, verbosity, and summary
+ * refresh seconds.
+ */
+type GenerativeAgentConfig = {
+  name: string;
+  age?: number;
+  traits: string;
+  status: string;
+  verbose?: boolean;
+  summaryRefreshSeconds?: number;
+};
+/**
+ * Implementation of a generative agent that can learn and form new memories over
+ * time. It extends the BaseChain class, which is a generic
+ * sequence of calls to components, including other chains.
+ * @example
+ * ```typescript
+ * const tommie: GenerativeAgent = new GenerativeAgent(
+ *   new OpenAI({ temperature: 0.9, maxTokens: 1500 }),
+ *   new GenerativeAgentMemory(
+ *     new ChatOpenAI({ model: "gpt-4o-mini" }),
+ *     new TimeWeightedVectorStoreRetriever({
+ *       vectorStore: new MemoryVectorStore(new OpenAIEmbeddings()),
+ *       otherScoreKeys: ["importance"],
+ *       k: 15,
+ *     }),
+ *     { reflectionThreshold: 8 },
+ *   ),
+ *   {
+ *     name: "Tommie",
+ *     age: 25,
+ *     traits: "anxious, likes design, talkative",
+ *     status: "looking for a job",
+ *   },
+ * );
+ *
+ * await tommie.addMemory(
+ *   "Tommie remembers his dog, Bruno, from when he was a kid",
+ *   new Date(),
+ * );
+ * const summary = await tommie.getSummary({ forceRefresh: true });
+ * const response = await tommie.generateDialogueResponse(
+ *   "USER says Hello Tommie, how are you today?",
+ * );
+ * ```
+ */
+declare class GenerativeAgent extends BaseChain {
+  static lc_name(): string;
+  // a character with memory and innate characterisitics
+  name: string; // the character's name
+  age?: number; // the optional age of the character
+  traits: string; // permanent traits to ascribe to the character
+  status: string; // the traits of the character you wish not to change
+  longTermMemory: GenerativeAgentMemory;
+  llm: BaseLanguageModelInterface; // the underlying language model
+  verbose: boolean; // false
+  private summary; // stateful self-summary generated via reflection on the character's memory.
+  private summaryRefreshSeconds;
+  private lastRefreshed; // the last time the character's summary was regenerated
+  // TODO: Add support for daily summaries
+  // private dailySummaries: string[] = []; // summary of the events in the plan that the agent took.
+  _chainType(): string;
+  get inputKeys(): string[];
+  get outputKeys(): string[];
+  constructor(llm: BaseLanguageModelInterface, longTermMemory: GenerativeAgentMemory, config: GenerativeAgentConfig);
+  // LLM methods
+  /**
+   * Parses a newline-separated string into a list of strings.
+   * @param text The string to parse.
+   * @returns An array of strings parsed from the input text.
+   */
+  parseList(text: string): string[];
+  /**
+   * Creates a new LLMChain with the given prompt and the agent's language
+   * model, verbosity, output key, and memory.
+   * @param prompt The prompt to use for the LLMChain.
+   * @returns A new LLMChain instance.
+   */
+  chain(prompt: PromptTemplate): LLMChain;
+  /**
+   * Extracts the observed entity from the given observation.
+   * @param observation The observation to extract the entity from.
+   * @param runManager Optional CallbackManagerForChainRun instance.
+   * @returns The extracted entity as a string.
+   */
+  getEntityFromObservations(observation: string, runManager?: CallbackManagerForChainRun): Promise<string>;
+  /**
+   * Extracts the action of the given entity from the given observation.
+   * @param observation The observation to extract the action from.
+   * @param entityName The name of the entity to extract the action for.
+   * @param runManager Optional CallbackManagerForChainRun instance.
+   * @returns The extracted action as a string.
+   */
+  getEntityAction(observation: string, entityName: string, runManager?: CallbackManagerForChainRun): Promise<string>;
+  /**
+   * Summarizes memories that are most relevant to an observation.
+   * @param observation The observation to summarize related memories for.
+   * @param runManager Optional CallbackManagerForChainRun instance.
+   * @returns The summarized memories as a string.
+   */
+  summarizeRelatedMemories(observation: string, runManager?: CallbackManagerForChainRun): Promise<string>;
+  _call(values: ChainValues, runManager?: CallbackManagerForChainRun): Promise<ChainValues>;
+  private _cleanResponse;
+  /**
+   * Generates a reaction to the given observation.
+   * @param observation The observation to generate a reaction for.
+   * @param now Optional current date.
+   * @returns A boolean indicating whether to continue the dialogue and the output string.
+   */
+  generateReaction(observation: string, now?: Date): Promise<[boolean, string]>;
+  /**
+   * Generates a dialogue response to the given observation.
+   * @param observation The observation to generate a dialogue response for.
+   * @param now Optional current date.
+   * @returns A boolean indicating whether to continue the dialogue and the output string.
+   */
+  generateDialogueResponse(observation: string, now?: Date): Promise<[boolean, string]>;
+  // Agent stateful' summary methods
+  // Each dialog or response prompt includes a header
+  // summarizing the agent's self-description. This is
+  // updated periodically through probing it's memories
+  /**
+   * Gets the agent's summary, which includes the agent's name, age, traits,
+   * and a summary of the agent's core characteristics. The summary is
+   * updated periodically through probing the agent's memories.
+   * @param config Optional configuration object with current date and a boolean to force refresh.
+   * @param runManager Optional CallbackManagerForChainRun instance.
+   * @returns The agent's summary as a string.
+   */
+  getSummary(config?: {
+    now?: Date;
+    forceRefresh?: boolean;
+  }, runManager?: CallbackManagerForChainRun): Promise<string>;
+  /**
+   * Computes the agent's summary by summarizing the agent's core
+   * characteristics given the agent's relevant memories.
+   * @param runManager Optional CallbackManagerForChainRun instance.
+   * @returns The computed summary as a string.
+   */
+  computeAgentSummary(runManager?: CallbackManagerForChainRun): Promise<string>;
+  /**
+   * Returns a full header of the agent's status, summary, and current time.
+   * @param config Optional configuration object with current date and a boolean to force refresh.
+   * @returns The full header as a string.
+   */
+  getFullHeader(config?: {
+    now?: Date;
+    forceRefresh?: boolean;
+  }): string;
+  /**
+   * Adds a memory to the agent's long-term memory.
+   * @param memoryContent The content of the memory to add.
+   * @param now Optional current date.
+   * @param metadata Optional metadata for the memory.
+   * @param callbacks Optional Callbacks instance.
+   * @returns The result of adding the memory to the agent's long-term memory.
+   */
+  addMemory(memoryContent: string, now?: Date, metadata?: Record<string, unknown>, callbacks?: Callbacks): Promise<ChainValues>;
+}
+//#endregion
+export { GenerativeAgent };
+//# sourceMappingURL=generative_agent.d.cts.map