@elizaos/plugin-experience 2.0.0-alpha.7 → 2.0.0-alpha.8

package/dist/actions/index.d.ts

@@ -0,0 +1,2 @@
+export { recordExperienceAction } from "./record-experience";
+//# sourceMappingURL=index.d.ts.map

package/dist/actions/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../actions/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/actions/record-experience.d.ts

@@ -0,0 +1,3 @@
+import { type Action } from "@elizaos/core";
+export declare const recordExperienceAction: Action;
+//# sourceMappingURL=record-experience.d.ts.map

package/dist/actions/record-experience.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"record-experience.d.ts","sourceRoot":"","sources":["../../actions/record-experience.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,MAAM,EAUZ,MAAM,eAAe,CAAC;AAKvB,eAAO,MAAM,sBAAsB,EAAE,MA+EpC,CAAC"}

package/dist/build.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env bun
+export {};
+//# sourceMappingURL=build.d.ts.map

package/dist/build.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../build.ts"],"names":[],"mappings":""}

package/dist/evaluators/experienceEvaluator.d.ts

@@ -0,0 +1,3 @@
+import { type Evaluator } from "@elizaos/core";
+export declare const experienceEvaluator: Evaluator;
+//# sourceMappingURL=experienceEvaluator.d.ts.map

package/dist/evaluators/experienceEvaluator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"experienceEvaluator.d.ts","sourceRoot":"","sources":["../../evaluators/experienceEvaluator.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,SAAS,EAQf,MAAM,eAAe,CAAC;AAavB,eAAO,MAAM,mBAAmB,EAAE,SA8MjC,CAAC"}

package/dist/generated/prompts/typescript/prompts.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Auto-generated prompt templates
+ * DO NOT EDIT - Generated from ../../../../prompts/*.txt
+ *
+ * These prompts use Handlebars-style template syntax:
+ * - {{variableName}} for simple substitution
+ * - {{#each items}}...{{/each}} for iteration
+ * - {{#if condition}}...{{/if}} for conditionals
+ */
+export declare const extractExperiencesTemplate = "# Task: Extract Novel Learning Experiences\n\nAnalyze this conversation for novel learning experiences that would be surprising or valuable to remember.\n\n## Conversation context\n{{conversation_context}}\n\n## Existing similar experiences\n{{existing_experiences}}\n\n## Instructions\nExtract ONLY experiences that are:\n1. Genuinely novel (not in existing experiences)\n2. Actionable learnings about how things work\n3. Corrections of previous mistakes or assumptions\n4. Discoveries of new capabilities or patterns\n5. Surprising outcomes that contradict expectations\n\nFocus on technical knowledge, patterns, and cause-effect relationships that transfer to other contexts.\nAvoid personal details, user-specific information, or routine interactions.\n\nRespond with JSON array of experiences (max 3):\n[{\n  \"type\": \"DISCOVERY|CORRECTION|SUCCESS|LEARNING\",\n  \"learning\": \"What was learned (generic, transferable)\",\n  \"context\": \"What situation triggered this (anonymized)\",\n  \"confidence\": 0.0-1.0,\n  \"reasoning\": \"Why this is novel and valuable\"\n}]\n\nReturn empty array [] if no novel experiences found.";
+export declare const EXTRACT_EXPERIENCES_TEMPLATE = "# Task: Extract Novel Learning Experiences\n\nAnalyze this conversation for novel learning experiences that would be surprising or valuable to remember.\n\n## Conversation context\n{{conversation_context}}\n\n## Existing similar experiences\n{{existing_experiences}}\n\n## Instructions\nExtract ONLY experiences that are:\n1. Genuinely novel (not in existing experiences)\n2. Actionable learnings about how things work\n3. Corrections of previous mistakes or assumptions\n4. Discoveries of new capabilities or patterns\n5. Surprising outcomes that contradict expectations\n\nFocus on technical knowledge, patterns, and cause-effect relationships that transfer to other contexts.\nAvoid personal details, user-specific information, or routine interactions.\n\nRespond with JSON array of experiences (max 3):\n[{\n  \"type\": \"DISCOVERY|CORRECTION|SUCCESS|LEARNING\",\n  \"learning\": \"What was learned (generic, transferable)\",\n  \"context\": \"What situation triggered this (anonymized)\",\n  \"confidence\": 0.0-1.0,\n  \"reasoning\": \"Why this is novel and valuable\"\n}]\n\nReturn empty array [] if no novel experiences found.";
+//# sourceMappingURL=prompts.d.ts.map

package/dist/generated/prompts/typescript/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../../../generated/prompts/typescript/prompts.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,eAAO,MAAM,0BAA0B,mnCA8Bc,CAAC;AAEtD,eAAO,MAAM,4BAA4B,mnCAA6B,CAAC"}

package/dist/generated/specs/spec-helpers.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Helper functions to lookup action/provider/evaluator specs by name.
+ * These allow language-specific implementations to import their text content
+ * (description, similes, examples) from the centralized specs.
+ *
+ * DO NOT EDIT the spec data - update prompts/actions.json, prompts/providers.json, prompts/evaluators.json and regenerate.
+ */
+import { type ActionDoc, type EvaluatorDoc, type ProviderDoc } from "./specs";
+/**
+ * Get an action spec by name from the core specs.
+ * @param name - The action name
+ * @returns The action spec or undefined if not found
+ */
+export declare function getActionSpec(name: string): ActionDoc | undefined;
+/**
+ * Get an action spec by name, throwing if not found.
+ * @param name - The action name
+ * @returns The action spec
+ * @throws Error if the action is not found
+ */
+export declare function requireActionSpec(name: string): ActionDoc;
+/**
+ * Get a provider spec by name from the core specs.
+ * @param name - The provider name
+ * @returns The provider spec or undefined if not found
+ */
+export declare function getProviderSpec(name: string): ProviderDoc | undefined;
+/**
+ * Get a provider spec by name, throwing if not found.
+ * @param name - The provider name
+ * @returns The provider spec
+ * @throws Error if the provider is not found
+ */
+export declare function requireProviderSpec(name: string): ProviderDoc;
+/**
+ * Get an evaluator spec by name from the core specs.
+ * @param name - The evaluator name
+ * @returns The evaluator spec or undefined if not found
+ */
+export declare function getEvaluatorSpec(name: string): EvaluatorDoc | undefined;
+/**
+ * Get an evaluator spec by name, throwing if not found.
+ * @param name - The evaluator name
+ * @returns The evaluator spec
+ * @throws Error if the evaluator is not found
+ */
+export declare function requireEvaluatorSpec(name: string): EvaluatorDoc;
+export type { ActionDoc, ProviderDoc, EvaluatorDoc };
+//# sourceMappingURL=spec-helpers.d.ts.map

package/dist/generated/specs/spec-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-helpers.d.ts","sourceRoot":"","sources":["../../../generated/specs/spec-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,KAAK,SAAS,EAOd,KAAK,YAAY,EACjB,KAAK,WAAW,EACjB,MAAM,SAAS,CAAC;AAgBjB;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAEjE;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAMzD;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAErE;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAM7D;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAEvE;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAM/D;AAGD,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,CAAC"}

package/dist/generated/specs/specs.d.ts

@@ -0,0 +1,159 @@
+/**
+ * Auto-generated canonical action/provider/evaluator docs for plugin-experience.
+ * DO NOT EDIT - Generated from prompts/specs/**.
+ */
+export type ActionDoc = {
+    name: string;
+    description: string;
+    similes?: readonly string[];
+    parameters?: readonly unknown[];
+    examples?: readonly (readonly unknown[])[];
+};
+export type ProviderDoc = {
+    name: string;
+    description: string;
+    position?: number;
+    dynamic?: boolean;
+};
+export type EvaluatorDoc = {
+    name: string;
+    description: string;
+    similes?: readonly string[];
+    alwaysRun?: boolean;
+    examples?: readonly unknown[];
+};
+export declare const coreActionsSpec: {
+    readonly version: "1.0.0";
+    readonly actions: readonly [{
+        readonly name: "RECORD_EXPERIENCE";
+        readonly description: "Record a learning or experience for future reference. Use this when the user explicitly asks you to remember something or when you've learned something important.";
+        readonly similes: readonly ["REMEMBER", "LEARN", "STORE_EXPERIENCE", "SAVE_EXPERIENCE", "RECORD_LEARNING"];
+        readonly parameters: readonly [];
+        readonly examples: readonly [readonly [{
+            readonly name: "{{name1}}";
+            readonly content: {
+                readonly text: "Remember that installing dependencies is required for Python scripts";
+            };
+        }, {
+            readonly name: "{{name2}}";
+            readonly content: {
+                readonly text: "I'll record that experience. Learning: Need to install dependencies before running Python scripts.";
+                readonly actions: readonly ["RECORD_EXPERIENCE"];
+            };
+        }], readonly [{
+            readonly name: "{{name1}}";
+            readonly content: {
+                readonly text: "Remember that users prefer shorter responses";
+            };
+        }, {
+            readonly name: "{{name2}}";
+            readonly content: {
+                readonly text: "I'll remember that preference.";
+                readonly actions: readonly ["RECORD_EXPERIENCE"];
+            };
+        }], readonly [{
+            readonly name: "{{name1}}";
+            readonly content: {
+                readonly text: "What's 2+2?";
+            };
+        }, {
+            readonly name: "{{name2}}";
+            readonly content: {
+                readonly text: "2+2 equals 4.";
+            };
+        }], readonly [{
+            readonly name: "{{name1}}";
+            readonly content: {
+                readonly text: "Can you help me with math?";
+            };
+        }, {
+            readonly name: "{{name2}}";
+            readonly content: {
+                readonly text: "Of course! What math problem do you need help with?";
+            };
+        }]];
+    }];
+};
+export declare const allActionsSpec: {
+    readonly version: "1.0.0";
+    readonly actions: readonly [{
+        readonly name: "RECORD_EXPERIENCE";
+        readonly description: "Record a learning or experience for future reference. Use this when the user explicitly asks you to remember something or when you've learned something important.";
+        readonly similes: readonly ["REMEMBER", "LEARN", "STORE_EXPERIENCE", "SAVE_EXPERIENCE", "RECORD_LEARNING"];
+        readonly parameters: readonly [];
+        readonly examples: readonly [readonly [{
+            readonly name: "{{name1}}";
+            readonly content: {
+                readonly text: "Remember that installing dependencies is required for Python scripts";
+            };
+        }, {
+            readonly name: "{{name2}}";
+            readonly content: {
+                readonly text: "I'll record that experience. Learning: Need to install dependencies before running Python scripts.";
+                readonly actions: readonly ["RECORD_EXPERIENCE"];
+            };
+        }], readonly [{
+            readonly name: "{{name1}}";
+            readonly content: {
+                readonly text: "Remember that users prefer shorter responses";
+            };
+        }, {
+            readonly name: "{{name2}}";
+            readonly content: {
+                readonly text: "I'll remember that preference.";
+                readonly actions: readonly ["RECORD_EXPERIENCE"];
+            };
+        }], readonly [{
+            readonly name: "{{name1}}";
+            readonly content: {
+                readonly text: "What's 2+2?";
+            };
+        }, {
+            readonly name: "{{name2}}";
+            readonly content: {
+                readonly text: "2+2 equals 4.";
+            };
+        }], readonly [{
+            readonly name: "{{name1}}";
+            readonly content: {
+                readonly text: "Can you help me with math?";
+            };
+        }, {
+            readonly name: "{{name2}}";
+            readonly content: {
+                readonly text: "Of course! What math problem do you need help with?";
+            };
+        }]];
+    }];
+};
+export declare const coreProvidersSpec: {
+    readonly version: "1.0.0";
+    readonly providers: readonly [{
+        readonly name: "experienceProvider";
+        readonly description: "Provides relevant past experiences and learnings for the current context";
+        readonly dynamic: true;
+    }];
+};
+export declare const allProvidersSpec: {
+    readonly version: "1.0.0";
+    readonly providers: readonly [{
+        readonly name: "experienceProvider";
+        readonly description: "Provides relevant past experiences and learnings for the current context";
+        readonly dynamic: true;
+    }];
+};
+export declare const coreEvaluatorsSpec: {
+    readonly version: "1.0.0";
+    readonly evaluators: readonly [];
+};
+export declare const allEvaluatorsSpec: {
+    readonly version: "1.0.0";
+    readonly evaluators: readonly [];
+};
+export declare const coreActionDocs: readonly ActionDoc[];
+export declare const allActionDocs: readonly ActionDoc[];
+export declare const coreProviderDocs: readonly ProviderDoc[];
+export declare const allProviderDocs: readonly ProviderDoc[];
+export declare const coreEvaluatorDocs: readonly EvaluatorDoc[];
+export declare const allEvaluatorDocs: readonly EvaluatorDoc[];
+//# sourceMappingURL=specs.d.ts.map

package/dist/generated/specs/specs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"specs.d.ts","sourceRoot":"","sources":["../../../generated/specs/specs.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,SAAS,GAAG;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B,UAAU,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;IAChC,QAAQ,CAAC,EAAE,SAAS,CAAC,SAAS,OAAO,EAAE,CAAC,EAAE,CAAC;CAC5C,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;CAC/B,CAAC;AAEF,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuElB,CAAC;AACX,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuEjB,CAAC;AACX,eAAO,MAAM,iBAAiB;;;;;;;CASpB,CAAC;AACX,eAAO,MAAM,gBAAgB;;;;;;;CASnB,CAAC;AACX,eAAO,MAAM,kBAAkB;;;CAGrB,CAAC;AACX,eAAO,MAAM,iBAAiB;;;CAGpB,CAAC;AAEX,eAAO,MAAM,cAAc,EAAE,SAAS,SAAS,EAA4B,CAAC;AAC5E,eAAO,MAAM,aAAa,EAAE,SAAS,SAAS,EAA2B,CAAC;AAC1E,eAAO,MAAM,gBAAgB,EAAE,SAAS,WAAW,EAAgC,CAAC;AACpF,eAAO,MAAM,eAAe,EAAE,SAAS,WAAW,EAA+B,CAAC;AAClF,eAAO,MAAM,iBAAiB,EAAE,SAAS,YAAY,EAAkC,CAAC;AACxF,eAAO,MAAM,gBAAgB,EAAE,SAAS,YAAY,EAAiC,CAAC"}

package/dist/index.browser.d.ts

@@ -0,0 +1,4 @@
+import type { Plugin } from "@elizaos/core";
+export declare const experiencePlugin: Plugin;
+export default experiencePlugin;
+//# sourceMappingURL=index.browser.d.ts.map

package/dist/index.browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.browser.d.ts","sourceRoot":"","sources":["../index.browser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiB,MAAM,EAAE,MAAM,eAAe,CAAC;AAK3D,eAAO,MAAM,gBAAgB,EAAE,MAQ9B,CAAC;AAEF,eAAe,gBAAgB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+import type { Plugin } from "@elizaos/core";
+import "./types";
+export declare const experiencePlugin: Plugin;
+export default experiencePlugin;
+export { ExperienceService } from "./service";
+export * from "./types";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiB,MAAM,EAAE,MAAM,eAAe,CAAC;AAM3D,OAAO,SAAS,CAAC;AAEjB,eAAO,MAAM,gBAAgB,EAAE,MAoB9B,CAAC;AAEF,eAAe,gBAAgB,CAAC;AAEhC,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,cAAc,SAAS,CAAC"}

package/dist/providers/experienceProvider.d.ts

@@ -0,0 +1,3 @@
+import { type Provider } from "@elizaos/core";
+export declare const experienceProvider: Provider;
+//# sourceMappingURL=experienceProvider.d.ts.map

package/dist/providers/experienceProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"experienceProvider.d.ts","sourceRoot":"","sources":["../../providers/experienceProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,QAAQ,EAGd,MAAM,eAAe,CAAC;AAUvB,eAAO,MAAM,kBAAkB,EAAE,QAsDhC,CAAC"}

package/dist/service.d.ts

@@ -0,0 +1,45 @@
+import { type IAgentRuntime, Service, type ServiceTypeName } from "@elizaos/core";
+import { type Experience, type ExperienceAnalysis, type ExperienceQuery, ExperienceType } from "./types";
+export declare class ExperienceService extends Service {
+    static serviceType: ServiceTypeName;
+    capabilityDescription: string;
+    private experiences;
+    private experiencesByDomain;
+    private experiencesByType;
+    private dirtyExperiences;
+    private persistTimer;
+    private decayManager;
+    private relationshipManager;
+    constructor(runtime: IAgentRuntime);
+    static start(runtime: IAgentRuntime): Promise<ExperienceService>;
+    private loadExperiences;
+    recordExperience(experienceData: Partial<Experience>): Promise<Experience>;
+    private saveExperienceToMemory;
+    private persistDirtyExperiences;
+    queryExperiences(query: ExperienceQuery): Promise<Experience[]>;
+    /** Apply query filters (type, outcome, domain, tags, confidence, importance, timeRange). */
+    private applyFilters;
+    /**
+     * Find similar experiences using vector search + reranking.
+     *
+     * Reranking strategy:
+     *   Vector similarity is the dominant signal (70%) — an irrelevant experience
+     *   should never outrank a relevant one just because it has high confidence.
+     *   Quality signals (confidence, importance) act as tiebreakers among
+     *   similarly-relevant results (30% combined).
+     *
+     *   A minimum similarity threshold filters out noise so quality signals
+     *   can't promote genuinely irrelevant experiences.
+     */
+    findSimilarExperiences(text: string, limit?: number): Promise<Experience[]>;
+    /** Fallback when embeddings are unavailable: sort by decayed confidence * importance. */
+    private fallbackSort;
+    analyzeExperiences(domain?: string, type?: ExperienceType): Promise<ExperienceAnalysis>;
+    private cosineSimilarity;
+    private findCommonPatterns;
+    private calculateOutcomeConsistency;
+    private extractAlternatives;
+    private generateRecommendations;
+    stop(): Promise<void>;
+}
+//# sourceMappingURL=service.d.ts.map

package/dist/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../service.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,aAAa,EAGlB,OAAO,EACP,KAAK,eAAe,EAErB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,KAAK,UAAU,EACf,KAAK,kBAAkB,EACvB,KAAK,eAAe,EAEpB,cAAc,EAEf,MAAM,SAAS,CAAC;AAIjB,qBAAa,iBAAkB,SAAQ,OAAO;IAC5C,OAAgB,WAAW,EAAE,eAAe,CAAoC;IACvE,qBAAqB,SACkE;IAEhG,OAAO,CAAC,WAAW,CAAoC;IACvD,OAAO,CAAC,mBAAmB,CAAqC;IAChE,OAAO,CAAC,iBAAiB,CAA6C;IACtE,OAAO,CAAC,gBAAgB,CAAwB;IAChD,OAAO,CAAC,YAAY,CAA+C;IACnE,OAAO,CAAC,YAAY,CAAyB;IAC7C,OAAO,CAAC,mBAAmB,CAAgC;gBAE/C,OAAO,EAAE,aAAa;WAarB,KAAK,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,iBAAiB,CAAC;YAMxD,eAAe;IAuEvB,gBAAgB,CAAC,cAAc,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC;YAmFlE,sBAAsB;YAyCtB,uBAAuB;IAyB/B,gBAAgB,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IA6DrE,4FAA4F;IAC5F,OAAO,CAAC,YAAY;IAqCpB;;;;;;;;;;;OAWG;IACG,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IA6E5E,yFAAyF;IACzF,OAAO,CAAC,YAAY;IAUd,kBAAkB,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAwC7F,OAAO,CAAC,gBAAgB;IAmBxB,OAAO,CAAC,kBAAkB;IAoB1B,OAAO,CAAC,2BAA2B;IAYnC,OAAO,CAAC,mBAAmB;IAmB3B,OAAO,CAAC,uBAAuB;IAkDzB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAyB5B"}

package/dist/types.d.ts

@@ -0,0 +1,89 @@
+import type { Memory, UUID } from "@elizaos/core";
+export type JsonPrimitive = string | number | boolean | null;
+export type JsonValue = JsonPrimitive | JsonValue[] | {
+    [key: string]: JsonValue;
+};
+export type JsonObject = {
+    [key: string]: JsonValue;
+};
+declare module "@elizaos/core" {
+    interface ServiceTypeRegistry {
+        EXPERIENCE: "EXPERIENCE";
+    }
+}
+export declare const ExperienceServiceType: {
+    EXPERIENCE: "EXPERIENCE";
+};
+export declare enum ExperienceType {
+    SUCCESS = "success",// Agent accomplished something
+    FAILURE = "failure",// Agent failed at something
+    DISCOVERY = "discovery",// Agent discovered new information
+    CORRECTION = "correction",// Agent corrected a mistake
+    LEARNING = "learning",// Agent learned something new
+    HYPOTHESIS = "hypothesis",// Agent formed a hypothesis
+    VALIDATION = "validation",// Agent validated a hypothesis
+    WARNING = "warning"
+}
+export declare enum OutcomeType {
+    POSITIVE = "positive",
+    NEGATIVE = "negative",
+    NEUTRAL = "neutral",
+    MIXED = "mixed"
+}
+export interface Experience {
+    id: UUID;
+    agentId: UUID;
+    type: ExperienceType;
+    outcome: OutcomeType;
+    context: string;
+    action: string;
+    result: string;
+    learning: string;
+    tags: string[];
+    domain: string;
+    relatedExperiences?: UUID[];
+    supersedes?: UUID;
+    confidence: number;
+    importance: number;
+    createdAt: number;
+    updatedAt: number;
+    lastAccessedAt?: number;
+    accessCount: number;
+    previousBelief?: string;
+    correctedBelief?: string;
+    embedding?: number[];
+    memoryIds?: UUID[];
+}
+export interface ExperienceQuery {
+    query?: string;
+    type?: ExperienceType | ExperienceType[];
+    outcome?: OutcomeType | OutcomeType[];
+    domain?: string | string[];
+    tags?: string[];
+    minImportance?: number;
+    minConfidence?: number;
+    timeRange?: {
+        start?: number;
+        end?: number;
+    };
+    limit?: number;
+    includeRelated?: boolean;
+}
+export interface ExperienceAnalysis {
+    pattern?: string;
+    frequency?: number;
+    reliability?: number;
+    alternatives?: string[];
+    recommendations?: string[];
+}
+export interface ExperienceEvent {
+    experienceId: UUID;
+    eventType: "created" | "accessed" | "updated" | "superseded";
+    timestamp: number;
+    metadata?: JsonObject;
+}
+export interface ExperienceMemory extends Memory {
+    experienceId: string;
+    experienceType: ExperienceType;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/utils/confidenceDecay.d.ts

@@ -0,0 +1,34 @@
+import type { Experience } from "../types";
+export interface DecayConfig {
+    halfLife: number;
+    minConfidence: number;
+    decayStartDelay: number;
+}
+export declare class ConfidenceDecayManager {
+    private config;
+    constructor(config?: Partial<DecayConfig>);
+    /**
+     * Calculate the decayed confidence for an experience
+     */
+    getDecayedConfidence(experience: Experience): number;
+    /**
+     * Get experiences that need reinforcement (low confidence due to decay)
+     */
+    getExperiencesNeedingReinforcement(experiences: Experience[], threshold?: number): Experience[];
+    /**
+     * Calculate reinforcement boost when an experience is validated
+     */
+    calculateReinforcementBoost(experience: Experience, validationStrength?: number): number;
+    /**
+     * Adjust decay rate based on experience type and domain
+     */
+    getDomainSpecificDecay(experience: Experience): DecayConfig;
+    /**
+     * Get confidence trend for an experience over time
+     */
+    getConfidenceTrend(experience: Experience, points?: number): Array<{
+        timestamp: number;
+        confidence: number;
+    }>;
+}
+//# sourceMappingURL=confidenceDecay.d.ts.map

package/dist/utils/confidenceDecay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"confidenceDecay.d.ts","sourceRoot":"","sources":["../../utils/confidenceDecay.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAG3C,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;CACzB;AAQD,qBAAa,sBAAsB;IACjC,OAAO,CAAC,MAAM,CAAc;gBAEhB,MAAM,GAAE,OAAO,CAAC,WAAW,CAAM;IAI7C;;OAEG;IACH,oBAAoB,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM;IAoBpD;;OAEG;IACH,kCAAkC,CAAC,WAAW,EAAE,UAAU,EAAE,EAAE,SAAS,SAAM,GAAG,UAAU,EAAE;IAO5F;;OAEG;IACH,2BAA2B,CAAC,UAAU,EAAE,UAAU,EAAE,kBAAkB,SAAM,GAAG,MAAM;IAMrF;;OAEG;IACH,sBAAsB,CAAC,UAAU,EAAE,UAAU,GAAG,WAAW;IAsC3D;;OAEG;IACH,kBAAkB,CAChB,UAAU,EAAE,UAAU,EACtB,MAAM,SAAK,GACV,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;CA0BpD"}

package/dist/utils/experienceAnalyzer.d.ts

@@ -0,0 +1,16 @@
+import type { Experience } from "../types";
+export interface ExperienceAnalysis {
+    isSignificant: boolean;
+    learning?: string;
+    confidence: number;
+    relatedExperiences?: string[];
+    actionableInsights?: string[];
+}
+export declare function analyzeExperience(partialExperience: Partial<Experience>, recentExperiences: Experience[]): Promise<ExperienceAnalysis>;
+export declare function detectPatterns(experiences: Experience[]): Promise<Array<{
+    description: string;
+    frequency: number;
+    experiences: string[];
+    significance: "low" | "medium" | "high";
+}>>;
+//# sourceMappingURL=experienceAnalyzer.d.ts.map

package/dist/utils/experienceAnalyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"experienceAnalyzer.d.ts","sourceRoot":"","sources":["../../utils/experienceAnalyzer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAG3C,MAAM,WAAW,kBAAkB;IACjC,aAAa,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC/B;AAED,wBAAsB,iBAAiB,CACrC,iBAAiB,EAAE,OAAO,CAAC,UAAU,CAAC,EACtC,iBAAiB,EAAE,UAAU,EAAE,GAC9B,OAAO,CAAC,kBAAkB,CAAC,CA4D7B;AAiED,wBAAsB,cAAc,CAAC,WAAW,EAAE,UAAU,EAAE,GAAG,OAAO,CACtE,KAAK,CAAC;IACJ,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,YAAY,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;CACzC,CAAC,CACH,CAqFA"}

package/dist/utils/experienceFormatter.d.ts

@@ -0,0 +1,23 @@
+import type { Experience } from "../types";
+import { ExperienceType, OutcomeType } from "../types";
+export declare function formatExperienceForDisplay(experience: Experience): string;
+export declare function formatExperienceSummary(experience: Experience): string;
+export declare function formatExperienceList(experiences: Experience[]): string;
+export declare function formatPatternSummary(pattern: {
+    description: string;
+    frequency: number;
+    significance: string;
+}): string;
+export declare function groupExperiencesByDomain(experiences: Experience[]): Map<string, Experience[]>;
+export declare function getExperienceStats(experiences: Experience[]): {
+    total: number;
+    byType: Record<ExperienceType, number>;
+    byOutcome: Record<OutcomeType, number>;
+    byDomain: Record<string, number>;
+    averageConfidence: number;
+    averageImportance: number;
+    successRate: number;
+};
+export declare function formatExperienceForRAG(experience: Experience): string;
+export declare function extractKeywords(experience: Experience): string[];
+//# sourceMappingURL=experienceFormatter.d.ts.map

package/dist/utils/experienceFormatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"experienceFormatter.d.ts","sourceRoot":"","sources":["../../utils/experienceFormatter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAEvD,wBAAgB,0BAA0B,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,CAWzE;AAED,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,CAGtE;AAED,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,UAAU,EAAE,GAAG,MAAM,CAQtE;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE;IAC5C,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;CACtB,GAAG,MAAM,CAST;AAED,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,UAAU,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC,CAU7F;AAED,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,UAAU,EAAE,GAAG;IAC7D,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;IACvC,SAAS,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IACvC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;CACrB,CA2CA;AAiBD,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,CAwBrE;AAED,wBAAgB,eAAe,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,EAAE,CA+BhE"}

package/dist/utils/experienceRelationships.d.ts

@@ -0,0 +1,25 @@
+import type { Experience, JsonObject } from "../types";
+export interface ExperienceChain {
+    rootExperience: string;
+    chain: string[];
+    strength: number;
+    validated: boolean;
+}
+export interface ExperienceRelationship {
+    fromId: string;
+    toId: string;
+    type: "causes" | "contradicts" | "supports" | "supersedes" | "related";
+    strength: number;
+    metadata?: JsonObject;
+}
+export declare class ExperienceRelationshipManager {
+    private relationships;
+    addRelationship(relationship: ExperienceRelationship): void;
+    findRelationships(experienceId: string, type?: string): ExperienceRelationship[];
+    detectCausalChain(experiences: Experience[]): ExperienceChain[];
+    private isRelated;
+    private contentSimilarity;
+    findContradictions(experience: Experience, allExperiences: Experience[]): Experience[];
+    getExperienceImpact(experienceId: string, allExperiences: Experience[]): number;
+}
+//# sourceMappingURL=experienceRelationships.d.ts.map

package/dist/utils/experienceRelationships.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"experienceRelationships.d.ts","sourceRoot":"","sources":["../../utils/experienceRelationships.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAGvD,MAAM,WAAW,eAAe;IAC9B,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,QAAQ,GAAG,aAAa,GAAG,UAAU,GAAG,YAAY,GAAG,SAAS,CAAC;IACvE,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,UAAU,CAAC;CACvB;AAED,qBAAa,6BAA6B;IACxC,OAAO,CAAC,aAAa,CAAoD;IAEzE,eAAe,CAAC,YAAY,EAAE,sBAAsB,GAAG,IAAI;IAQ3D,iBAAiB,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,sBAAsB,EAAE;IAQhF,iBAAiB,CAAC,WAAW,EAAE,UAAU,EAAE,GAAG,eAAe,EAAE;IAgD/D,OAAO,CAAC,SAAS;IAejB,OAAO,CAAC,iBAAiB;IAWzB,kBAAkB,CAAC,UAAU,EAAE,UAAU,EAAE,cAAc,EAAE,UAAU,EAAE,GAAG,UAAU,EAAE;IAyBtF,mBAAmB,CAAC,YAAY,EAAE,MAAM,EAAE,cAAc,EAAE,UAAU,EAAE,GAAG,MAAM;CAmBhF"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@elizaos/plugin-experience",
   "description": "Experience learning plugin for ElizaOS - records and recalls transferable agent learnings",
-  "version": "2.0.0-alpha.7",
+  "version": "2.0.0-alpha.8",
   "type": "module",
   "main": "dist/node/index.node.js",
   "module": "dist/node/index.node.js",
@@ -44,7 +44,7 @@
   ],
   "sideEffects": false,
   "dependencies": {
-    "@elizaos/core": "2.0.0-alpha.3",
+    "@elizaos/core": "2.0.0-alpha.12",
     "uuid": "^13.0.0"
   },
   "devDependencies": {