@elizaos/agent 2.0.0-alpha.173 → 2.0.0-alpha.192

package/packages/typescript/src/schemas/entity-identity.js

@@ -0,0 +1,334 @@
+/**
+ * Strengthened, normalized record of a (platform, handle) claim attached to an
+ * entity. Lives alongside (and is more authoritative than) the legacy
+ * `metadata.platformIdentities` array on entity rows.
+ *
+ * Each row carries provenance: which messages observed the claim, what the
+ * source extractor scored its confidence at, and when it was first/last seen.
+ * The (platform, handle) pair is unique per entity so re-observations bump
+ * confidence + evidence rather than producing duplicate rows.
+ */
+export const entityIdentitySchema = {
+    name: "entity_identities",
+    schema: "",
+    columns: {
+        id: {
+            name: "id",
+            type: "uuid",
+            primaryKey: true,
+            notNull: true,
+            default: "gen_random_uuid()",
+        },
+        entity_id: {
+            name: "entity_id",
+            type: "uuid",
+            notNull: true,
+        },
+        agent_id: {
+            name: "agent_id",
+            type: "uuid",
+            notNull: true,
+        },
+        platform: {
+            name: "platform",
+            type: "text",
+            notNull: true,
+        },
+        handle: {
+            name: "handle",
+            type: "text",
+            notNull: true,
+        },
+        verified: {
+            name: "verified",
+            type: "boolean",
+            notNull: true,
+            default: false,
+        },
+        confidence: {
+            name: "confidence",
+            type: "real",
+            notNull: true,
+            default: 0,
+        },
+        source: {
+            name: "source",
+            type: "text",
+        },
+        first_seen: {
+            name: "first_seen",
+            type: "timestamp",
+            notNull: true,
+            default: "now()",
+        },
+        last_seen: {
+            name: "last_seen",
+            type: "timestamp",
+            notNull: true,
+            default: "now()",
+        },
+        evidence_message_ids: {
+            name: "evidence_message_ids",
+            type: "jsonb",
+        },
+        created_at: {
+            name: "created_at",
+            type: "timestamp",
+            notNull: true,
+            default: "now()",
+        },
+    },
+    indexes: {
+        idx_entity_identities_entity: {
+            name: "idx_entity_identities_entity",
+            columns: [{ expression: "entity_id", isExpression: false }],
+            isUnique: false,
+        },
+        idx_entity_identities_platform_handle: {
+            name: "idx_entity_identities_platform_handle",
+            columns: [
+                { expression: "platform", isExpression: false },
+                { expression: "handle", isExpression: false },
+            ],
+            isUnique: false,
+        },
+    },
+    foreignKeys: {
+        fk_entity_identities_entity: {
+            name: "fk_entity_identities_entity",
+            tableFrom: "entity_identities",
+            tableTo: "entities",
+            columnsFrom: ["entity_id"],
+            columnsTo: ["id"],
+            onDelete: "cascade",
+            schemaTo: "",
+        },
+        fk_entity_identities_agent: {
+            name: "fk_entity_identities_agent",
+            tableFrom: "entity_identities",
+            tableTo: "agents",
+            columnsFrom: ["agent_id"],
+            columnsTo: ["id"],
+            onDelete: "cascade",
+            schemaTo: "",
+        },
+    },
+    compositePrimaryKeys: {},
+    uniqueConstraints: {
+        unique_entity_identity: {
+            name: "unique_entity_identity",
+            columns: ["entity_id", "platform", "handle", "agent_id"],
+        },
+    },
+    checkConstraints: {},
+};
+/**
+ * Pending merge proposals between two entities. Created when an identity claim
+ * collision indicates two distinct entity rows actually represent the same
+ * person. A human (or auto-merge threshold) flips `status` to "accepted" /
+ * "rejected"; on accept the merge is applied transactionally.
+ */
+export const entityMergeCandidateSchema = {
+    name: "entity_merge_candidates",
+    schema: "",
+    columns: {
+        id: {
+            name: "id",
+            type: "uuid",
+            primaryKey: true,
+            notNull: true,
+            default: "gen_random_uuid()",
+        },
+        agent_id: {
+            name: "agent_id",
+            type: "uuid",
+            notNull: true,
+        },
+        entity_a: {
+            name: "entity_a",
+            type: "uuid",
+            notNull: true,
+        },
+        entity_b: {
+            name: "entity_b",
+            type: "uuid",
+            notNull: true,
+        },
+        confidence: {
+            name: "confidence",
+            type: "real",
+            notNull: true,
+            default: 0,
+        },
+        evidence: {
+            name: "evidence",
+            type: "jsonb",
+        },
+        status: {
+            name: "status",
+            type: "text",
+            notNull: true,
+            default: "'pending'",
+        },
+        proposed_at: {
+            name: "proposed_at",
+            type: "timestamp",
+            notNull: true,
+            default: "now()",
+        },
+        resolved_at: {
+            name: "resolved_at",
+            type: "timestamp",
+        },
+    },
+    indexes: {
+        idx_entity_merge_candidates_status: {
+            name: "idx_entity_merge_candidates_status",
+            columns: [{ expression: "status", isExpression: false }],
+            isUnique: false,
+        },
+        idx_entity_merge_candidates_pair: {
+            name: "idx_entity_merge_candidates_pair",
+            columns: [
+                { expression: "entity_a", isExpression: false },
+                { expression: "entity_b", isExpression: false },
+            ],
+            isUnique: false,
+        },
+    },
+    foreignKeys: {
+        fk_entity_merge_candidates_a: {
+            name: "fk_entity_merge_candidates_a",
+            tableFrom: "entity_merge_candidates",
+            tableTo: "entities",
+            columnsFrom: ["entity_a"],
+            columnsTo: ["id"],
+            onDelete: "cascade",
+            schemaTo: "",
+        },
+        fk_entity_merge_candidates_b: {
+            name: "fk_entity_merge_candidates_b",
+            tableFrom: "entity_merge_candidates",
+            tableTo: "entities",
+            columnsFrom: ["entity_b"],
+            columnsTo: ["id"],
+            onDelete: "cascade",
+            schemaTo: "",
+        },
+        fk_entity_merge_candidates_agent: {
+            name: "fk_entity_merge_candidates_agent",
+            tableFrom: "entity_merge_candidates",
+            tableTo: "agents",
+            columnsFrom: ["agent_id"],
+            columnsTo: ["id"],
+            onDelete: "cascade",
+            schemaTo: "",
+        },
+    },
+    compositePrimaryKeys: {},
+    uniqueConstraints: {},
+    checkConstraints: {},
+};
+/**
+ * Fact refinement candidates. When the FactRefinementEvaluator detects a
+ * contradiction or merge opportunity that we cannot apply automatically, it
+ * writes a row here for the user to resolve in the Facts tab.
+ */
+export const factCandidateSchema = {
+    name: "fact_candidates",
+    schema: "",
+    columns: {
+        id: {
+            name: "id",
+            type: "uuid",
+            primaryKey: true,
+            notNull: true,
+            default: "gen_random_uuid()",
+        },
+        agent_id: {
+            name: "agent_id",
+            type: "uuid",
+            notNull: true,
+        },
+        entity_id: {
+            name: "entity_id",
+            type: "uuid",
+            notNull: true,
+        },
+        kind: {
+            name: "kind",
+            type: "text",
+            notNull: true,
+        },
+        existing_fact_id: {
+            name: "existing_fact_id",
+            type: "uuid",
+        },
+        proposed_text: {
+            name: "proposed_text",
+            type: "text",
+            notNull: true,
+        },
+        confidence: {
+            name: "confidence",
+            type: "real",
+            notNull: true,
+            default: 0,
+        },
+        evidence: {
+            name: "evidence",
+            type: "jsonb",
+        },
+        status: {
+            name: "status",
+            type: "text",
+            notNull: true,
+            default: "'pending'",
+        },
+        proposed_at: {
+            name: "proposed_at",
+            type: "timestamp",
+            notNull: true,
+            default: "now()",
+        },
+        resolved_at: {
+            name: "resolved_at",
+            type: "timestamp",
+        },
+    },
+    indexes: {
+        idx_fact_candidates_status: {
+            name: "idx_fact_candidates_status",
+            columns: [{ expression: "status", isExpression: false }],
+            isUnique: false,
+        },
+        idx_fact_candidates_entity: {
+            name: "idx_fact_candidates_entity",
+            columns: [{ expression: "entity_id", isExpression: false }],
+            isUnique: false,
+        },
+    },
+    foreignKeys: {
+        fk_fact_candidates_entity: {
+            name: "fk_fact_candidates_entity",
+            tableFrom: "fact_candidates",
+            tableTo: "entities",
+            columnsFrom: ["entity_id"],
+            columnsTo: ["id"],
+            onDelete: "cascade",
+            schemaTo: "",
+        },
+        fk_fact_candidates_agent: {
+            name: "fk_fact_candidates_agent",
+            tableFrom: "fact_candidates",
+            tableTo: "agents",
+            columnsFrom: ["agent_id"],
+            columnsTo: ["id"],
+            onDelete: "cascade",
+            schemaTo: "",
+        },
+    },
+    compositePrimaryKeys: {},
+    uniqueConstraints: {},
+    checkConstraints: {},
+};

package/packages/typescript/src/schemas/index.d.ts

@@ -18,6 +18,8 @@ import { channelParticipantSchema } from "./channel-participant.ts";
 import { componentSchema } from "./component.ts";
 import { embeddingSchema } from "./embedding.ts";
 import { entitySchema } from "./entity.ts";
+import { entityIdentitySchema, entityMergeCandidateSchema, factCandidateSchema } from "./entity-identity.ts";
+export type { EntityMergeCandidateStatus, FactCandidateKind, FactCandidateStatus, } from "./entity-identity.ts";
 import { logSchema } from "./log.ts";
 import { memorySchema } from "./memory.ts";
 import { messageSchema } from "./message.ts";
@@ -31,7 +33,7 @@ import { roomSchema } from "./room.ts";
 import { serverSchema } from "./server.ts";
 import { taskSchema } from "./task.ts";
 import { worldSchema } from "./world.ts";
-export { agentSchema, cacheSchema, channelParticipantSchema, channelSchema, componentSchema, embeddingSchema, entitySchema, logSchema, longTermMemories, memoryAccessLogs, memorySchema, messageSchema, messageServerAgentSchema, messageServerSchema, pairingAllowlistSchema, pairingRequestSchema, participantSchema, relationshipSchema, roomSchema, serverSchema, sessionSummaries, taskSchema, worldSchema, };
+export { agentSchema, cacheSchema, channelParticipantSchema, channelSchema, componentSchema, embeddingSchema, entityIdentitySchema, entityMergeCandidateSchema, entitySchema, factCandidateSchema, logSchema, longTermMemories, memoryAccessLogs, memorySchema, messageSchema, messageServerAgentSchema, messageServerSchema, pairingAllowlistSchema, pairingRequestSchema, participantSchema, relationshipSchema, roomSchema, serverSchema, sessionSummaries, taskSchema, worldSchema, };
 /**
  * Type for the object returned by buildBaseTables().
  * Represents all 20 core database tables as ORM table objects.

package/packages/typescript/src/schemas/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../typescript/src/schemas/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EACN,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,MAAM,8CAA8C,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC/E,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAGzC,OAAO,EACN,WAAW,EACX,WAAW,EACX,wBAAwB,EACxB,aAAa,EACb,eAAe,EACf,eAAe,EACf,YAAY,EACZ,SAAS,EAET,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACZ,aAAa,EACb,wBAAwB,EACxB,mBAAmB,EACnB,sBAAsB,EACtB,oBAAoB,EACpB,iBAAiB,EACjB,kBAAkB,EAClB,UAAU,EACV,YAAY,EACZ,gBAAgB,EAChB,UAAU,EACV,WAAW,GACX,CAAC;AAEF;;;GAGG;AACH,MAAM,WAAW,UAAU;IAC1B,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;IAChB,GAAG,EAAE,OAAO,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,OAAO,CAAC;IACvB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,gBAAgB,EAAE,OAAO,CAAC;IAC1B,cAAc,EAAE,OAAO,CAAC;IACxB,WAAW,EAAE,OAAO,CAAC;IACrB,YAAY,EAAE,OAAO,CAAC;IACtB,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;CACf;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAC9B,UAAU,EAAE,YAAY,EACxB,OAAO,EAAE,cAAc,GACrB,UAAU,CAuBZ"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../typescript/src/schemas/index.ts"],"names":[],"mappings":"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"}

package/packages/typescript/src/schemas/index.js

@@ -18,6 +18,7 @@ import { channelParticipantSchema } from "./channel-participant.js";
 import { componentSchema } from "./component.js";
 import { embeddingSchema } from "./embedding.js";
 import { entitySchema } from "./entity.js";
+import { entityIdentitySchema, entityMergeCandidateSchema, factCandidateSchema, } from "./entity-identity.js";
 import { logSchema } from "./log.js";
 import { memorySchema } from "./memory.js";
 import { messageSchema } from "./message.js";
@@ -32,7 +33,7 @@ import { serverSchema } from "./server.js";
 import { taskSchema } from "./task.js";
 import { worldSchema } from "./world.js";
 // Export all abstract schemas
-export { agentSchema, cacheSchema, channelParticipantSchema, channelSchema, componentSchema, embeddingSchema, entitySchema, logSchema, 
+export { agentSchema, cacheSchema, channelParticipantSchema, channelSchema, componentSchema, embeddingSchema, entityIdentitySchema, entityMergeCandidateSchema, entitySchema, factCandidateSchema, logSchema, 
 // Advanced memory schemas
 longTermMemories, memoryAccessLogs, memorySchema, messageSchema, messageServerAgentSchema, messageServerSchema, pairingAllowlistSchema, pairingRequestSchema, participantSchema, relationshipSchema, roomSchema, serverSchema, sessionSummaries, taskSchema, worldSchema, };
 /**

package/packages/typescript/src/search.d.ts

@@ -224,19 +224,6 @@ export declare class BM25 {
      * @param options - Configuration options for BM25 parameters (k1, b), tokenizer (stopWords, stemming, minLength), and field boosts.
      */
     constructor(docs?: Array<Record<string, unknown>>, options?: BM25Options);
-    /**
-     * Processes an array of documents to build the initial index structures.
-     * Calculates document lengths, term frequencies, document frequencies, and average document length.
-     * @param docs - Array of documents to process.
-     * @returns An object containing the calculated index data.
-     * @internal
-     */
-    private processDocuments;
-    /**
-     * Recalculates the average document length based on the current `documentLengths`.
-     * @internal
-     */
-    private recalculateAverageLength;
     /**
      * Searches the indexed documents for a given query string using the BM25 ranking formula.
      *
@@ -255,15 +242,6 @@ export declare class BM25 {
      * @returns An array of `SearchResult` objects, sorted by score, for documents containing the phrase.
      */
     searchPhrase(phrase: string, topK?: number): SearchResult[];
-    /**
-     * Calculates a BM25-like score for a sequence of phrase tokens within a specific document.
-     * Sums the individual BM25 scores of the terms in the phrase for that document.
-     * @param phraseTokens - The tokenized phrase.
-     * @param docIndex - The index of the document to score against.
-     * @returns The calculated phrase score for the document.
-     * @internal
-     */
-    private calculatePhraseScore;
     /**
      * Adds a single new document to the index.
      * Updates all internal index structures incrementally.

package/packages/typescript/src/search.d.ts.map

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

package/packages/typescript/src/services/message.d.ts

@@ -22,6 +22,17 @@ export declare const RESERVED_XML_KEYS: Set<string>;
  */
 export declare function extractStandaloneActionParams(actionNames: string[], parsedXml: Record<string, unknown>): string;
 export declare function isSimpleReplyResponse(responseContent: Pick<Content, "actions"> | null | undefined): boolean;
+/**
+ * True when the planner's `text` field should be surfaced to the user as a
+ * preamble before action handlers run in actions-mode dispatch. The goal:
+ * the user sees "checking your inbox" rather than silence while INBOX/GMAIL
+ * do their work.
+ *
+ * Skipped when the first action is REPLY (the REPLY handler generates its own
+ * text), IGNORE (no user-visible response), or STOP (terminal). Also skipped
+ * when `text` is empty.
+ */
+export declare function shouldEmitPlannerPreamble(responseContent: Pick<Content, "text" | "actions"> | null | undefined): boolean;
 /**
  * Default implementation of the MessageService interface.
  * This service handles the complete message processing pipeline including:

package/packages/typescript/src/services/message.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"message.d.ts","sourceRoot":"","sources":["../../../../../../typescript/src/services/message.ts"],"names":[],"mappings":"AA0BA,OAAO,KAAK,EAGX,eAAe,EAEf,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAGjD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,KAAK,EACX,6BAA6B,EAE7B,eAAe,EACf,wBAAwB,EACxB,uBAAuB,EAEvB,MAAM,0BAA0B,CAAC;AAclC,OAAO,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAEhF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAiCtD;;;GAGG;AACH,eAAO,MAAM,iBAAiB,aAM5B,CAAC;AAkIH;;;;;;;;;;GAUG;AACH,wBAAgB,6BAA6B,CAC5C,WAAW,EAAE,MAAM,EAAE,EACrB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,MAAM,CAiBR;AAkSD,wBAAgB,qBAAqB,CACpC,eAAe,EAAE,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,GAAG,IAAI,GAAG,SAAS,GAC1D,OAAO,CAOT;AA4jBD;;;;;;;;;;;;GAYG;AACH,qBAAa,qBAAsB,YAAW,eAAe;IAC5D;;OAEG;IACG,aAAa,CAClB,OAAO,EAAE,aAAa,EACtB,OAAO,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,eAAe,EAC1B,OAAO,CAAC,EAAE,wBAAwB,GAChC,OAAO,CAAC,uBAAuB,CAAC;IAwmBnC;;OAEG;YACW,cAAc;YA6zBd,qCAAqC;IAmNnD;;;OAGG;IACH,aAAa,CACZ,OAAO,EAAE,aAAa,EACtB,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,IAAI,EACX,cAAc,CAAC,EAAE,cAAc,GAC7B,6BAA6B;IAoIhC;;OAEG;IACG,kBAAkB,CACvB,OAAO,EAAE,aAAa,EACtB,WAAW,EAAE,KAAK,EAAE,GAClB,OAAO,CAAC,KAAK,EAAE,CAAC;YAqSL,yBAAyB;YAuMzB,6BAA6B;IAmM3C;;;OAGG;YACW,iBAAiB;YAmXjB,2BAA2B;IA2IzC;;OAEG;YACW,gBAAgB;IAqf9B;;OAEG;YACW,YAAY;YAqBZ,eAAe;IAY7B;;;;;;;OAOG;IACG,aAAa,CAAC,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAyB3E;;;;;;;;OAQG;IACG,YAAY,CACjB,OAAO,EAAE,aAAa,EACtB,MAAM,EAAE,IAAI,EACZ,SAAS,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC;CA4ChB"}
+{"version":3,"file":"message.d.ts","sourceRoot":"","sources":["../../../../../../typescript/src/services/message.ts"],"names":[],"mappings":"AA+BA,OAAO,KAAK,EAGX,eAAe,EAEf,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAGjD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,KAAK,EACX,6BAA6B,EAE7B,eAAe,EACf,wBAAwB,EACxB,uBAAuB,EAEvB,MAAM,0BAA0B,CAAC;AAclC,OAAO,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAEhF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAiCtD;;;GAGG;AACH,eAAO,MAAM,iBAAiB,aAM5B,CAAC;AAkIH;;;;;;;;;;GAUG;AACH,wBAAgB,6BAA6B,CAC5C,WAAW,EAAE,MAAM,EAAE,EACrB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,MAAM,CAiBR;AAkSD,wBAAgB,qBAAqB,CACpC,eAAe,EAAE,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,GAAG,IAAI,GAAG,SAAS,GAC1D,OAAO,CAOT;AAmGD;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CACxC,eAAe,EAAE,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC,GAAG,IAAI,GAAG,SAAS,GACnE,OAAO,CAiBT;AA6bD;;;;;;;;;;;;GAYG;AACH,qBAAa,qBAAsB,YAAW,eAAe;IAC5D;;OAEG;IACG,aAAa,CAClB,OAAO,EAAE,aAAa,EACtB,OAAO,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,eAAe,EAC1B,OAAO,CAAC,EAAE,wBAAwB,GAChC,OAAO,CAAC,uBAAuB,CAAC;IAwmBnC;;OAEG;YACW,cAAc;YAi1Bd,qCAAqC;IA2NnD;;;OAGG;IACH,aAAa,CACZ,OAAO,EAAE,aAAa,EACtB,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,IAAI,EACX,cAAc,CAAC,EAAE,cAAc,GAC7B,6BAA6B;IAoIhC;;OAEG;IACG,kBAAkB,CACvB,OAAO,EAAE,aAAa,EACtB,WAAW,EAAE,KAAK,EAAE,GAClB,OAAO,CAAC,KAAK,EAAE,CAAC;YA4SL,yBAAyB;YAuMzB,6BAA6B;IAmM3C;;;OAGG;YACW,iBAAiB;YAsXjB,2BAA2B;IA2IzC;;OAEG;YACW,gBAAgB;IA6f9B;;OAEG;YACW,YAAY;YAqBZ,eAAe;IAY7B;;;;;;;OAOG;IACG,aAAa,CAAC,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAyB3E;;;;;;;;OAQG;IACG,YAAY,CACjB,OAAO,EAAE,aAAa,EACtB,MAAM,EAAE,IAAI,EACZ,SAAS,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC;CA4ChB"}

package/packages/typescript/src/services/message.js

@@ -5,6 +5,8 @@ import { formatTaskCompletionStatus, getTaskCompletionCacheKey, } from "../featu
 import { logger } from "../logger";
 import { imageDescriptionTemplate, messageHandlerTemplate, multiStepDecisionTemplate, multiStepSummaryTemplate, postActionDecisionTemplate, shouldRespondTemplate, } from "../prompts";
 import { isExplicitSelfModificationRequest } from "../should-respond";
+import { OPTIMIZED_PROMPT_SERVICE, } from "./optimized-prompt";
+import { resolveOptimizedPrompt } from "./optimized-prompt-resolver";
 import { getModelStreamChunkDeliveryDepth, runWithStreamingContext, } from "../streaming-context";
 import { runWithTrajectoryContext, setTrajectoryPurpose, } from "../trajectory-context";
 import { EventType } from "../types/events";
@@ -390,27 +392,30 @@ function suppressesPostActionContinuation(runtime, responseContent) {
             ?.suppressPostActionContinuation === true);
     });
 }
-function stripPlannerReplyForSuppressiveActions(runtime, responseContent) {
-    if (!responseContent?.actions?.length) {
-        return;
-    }
-    if (!suppressesPostActionContinuation(runtime, responseContent)) {
-        return;
-    }
-    const actionLookup = buildRuntimeActionLookup(runtime);
-    const filteredActions = responseContent.actions.filter((action) => {
-        if (typeof action !== "string")
-            return true;
-        const canonicalAction = resolveRuntimeAction(actionLookup, action)?.name ?? action;
-        return (normalizeActionIdentifier(canonicalAction) !==
-            normalizeActionIdentifier("REPLY"));
-    });
-    if (filteredActions.length > 0) {
-        responseContent.actions = filteredActions;
-    }
-    if (typeof responseContent.text === "string" && responseContent.text.trim()) {
-        responseContent.text = "";
-    }
+/**
+ * True when the planner's `text` field should be surfaced to the user as a
+ * preamble before action handlers run in actions-mode dispatch. The goal:
+ * the user sees "checking your inbox" rather than silence while INBOX/GMAIL
+ * do their work.
+ *
+ * Skipped when the first action is REPLY (the REPLY handler generates its own
+ * text), IGNORE (no user-visible response), or STOP (terminal). Also skipped
+ * when `text` is empty.
+ */
+export function shouldEmitPlannerPreamble(responseContent) {
+    if (!responseContent)
+        return false;
+    const text = typeof responseContent.text === "string" ? responseContent.text.trim() : "";
+    if (text.length === 0)
+        return false;
+    const firstAction = typeof responseContent.actions?.[0] === "string"
+        ? normalizeActionIdentifier(responseContent.actions[0])
+        : "";
+    if (firstAction.length === 0)
+        return false;
+    return (firstAction !== normalizeActionIdentifier("REPLY") &&
+        firstAction !== normalizeActionIdentifier("IGNORE") &&
+        firstAction !== normalizeActionIdentifier("STOP"));
 }
 function callbackTextPreview(content) {
     if (!content || typeof content !== "object") {
@@ -1443,8 +1448,16 @@ export class DefaultMessageService {
             if (responseContent?.providers && responseContent.providers.length > 0) {
                 state = await runtime.composeState(message, responseContent.providers, false, false);
             }
-            // Save response memory to database (simple mode persists after hooks; see below)
-            if (responseMessages.length > 0 && mode !== "simple") {
+            // Save response memory to database.
+            // - simple mode: persists after hooks in the branch below.
+            // - actions mode: do NOT persist the initial LLM text here.
+            //   The action callbacks produce the real user-facing messages;
+            //   saving the planner text now would emit a premature reply that
+            //   may be contradicted once the action completes or fails.
+            // - other non-simple modes (e.g. "none"): persist immediately.
+            if (responseMessages.length > 0 &&
+                mode !== "simple" &&
+                mode !== "actions") {
                 for (const responseMemory of responseMessages) {
                     // Update the content in case inReplyTo was added
                     if (responseContent) {
@@ -1488,6 +1501,15 @@ export class DefaultMessageService {
                     pendingSimpleEmit = responseContent;
                 }
                 else if (mode === "actions") {
+                    // Surface the planner's text before action handlers run, so the
+                    // user sees the agent's plan rather than silence. The full
+                    // responseContent is already persisted as a memory above.
+                    if (callback && shouldEmitPlannerPreamble(responseContent)) {
+                        await callback({
+                            ...responseContent,
+                            actions: [],
+                        });
+                    }
                     // Pass onStreamChunk to processActions so each action can manage its own streaming context
                     await runtime.processActions(message, responseMessages, state, async (content) => {
                         runtime.logger.debug({ src: "service:message", content }, "Action callback");
@@ -1784,10 +1806,13 @@ export class DefaultMessageService {
                 },
             };
             const shouldRespondState = prepareShouldRespondState(workingState);
+            const optimizedPromptService = runtime.getService(OPTIMIZED_PROMPT_SERVICE);
+            const baselineShouldRespond = runtime.character.templates?.shouldRespondTemplate ||
+                shouldRespondTemplate;
+            const resolvedShouldRespondTemplate = resolveOptimizedPrompt(optimizedPromptService, "should_respond", baselineShouldRespond);
             const _shouldRespondPrompt = composePromptFromState({
                 state: shouldRespondState,
-                template: runtime.character.templates?.shouldRespondTemplate ||
-                    shouldRespondTemplate,
+                template: resolvedShouldRespondTemplate,
             });
             runtime.logger.debug({
                 src: "service:message",
@@ -1799,8 +1824,7 @@ export class DefaultMessageService {
             const responseObject = await runtime.dynamicPromptExecFromState({
                 state: shouldRespondState,
                 params: {
-                    prompt: runtime.character.templates?.shouldRespondTemplate ||
-                        shouldRespondTemplate,
+                    prompt: resolvedShouldRespondTemplate,
                     ...(promptAttachments ? { attachments: promptAttachments } : {}),
                 },
                 schema: [
@@ -2052,8 +2076,10 @@ export class DefaultMessageService {
                     const contentType = res.headers.get("content-type") || "application/octet-stream";
                     imageUrl = `data:${contentType};base64,${buffer.toString("base64")}`;
                 }
+                const optimizedMediaService = runtime.getService(OPTIMIZED_PROMPT_SERVICE);
+                const resolvedImagePrompt = resolveOptimizedPrompt(optimizedMediaService, "media_description", imageDescriptionTemplate);
                 const response = await runtime.useModel(ModelType.IMAGE_DESCRIPTION, {
-                    prompt: imageDescriptionTemplate,
+                    prompt: resolvedImagePrompt,
                     imageUrl,
                 });
                 if (typeof response === "string") {
@@ -2427,9 +2453,11 @@ export class DefaultMessageService {
             : undefined;
         // Resolve the template prompt once so it's available for both the primary
         // call and any follow-up repair prompts (e.g. parameter repair).
-        const prompt = overrides?.prompt ||
-            runtime.character.templates?.messageHandlerTemplate ||
+        const optimizedResponseService = runtime.getService(OPTIMIZED_PROMPT_SERVICE);
+        const baselineResponseTemplate = runtime.character.templates?.messageHandlerTemplate ||
             messageHandlerTemplate;
+        const prompt = overrides?.prompt ||
+            resolveOptimizedPrompt(optimizedResponseService, "response", baselineResponseTemplate);
         // Use dynamicPromptExecFromState for structured output with validation
         setTrajectoryPurpose("response");
         const parsedXml = await runtime.dynamicPromptExecFromState({
@@ -2676,10 +2704,6 @@ Output ONLY the continuation, starting immediately after the last character abov
                 responseContent.actions = filtered.length ? filtered : ["STOP"];
             }
         }
-        // Some actions are intended to provide the only grounded user-facing answer.
-        // If the planner emits both REPLY/text and one of those actions, drop the
-        // speculative planner text before persisting/sending the initial assistant turn.
-        stripPlannerReplyForSuppressiveActions(runtime, responseContent);
         // Automatically determine if response is simple
         const isSimple = isSimpleReplyResponse(responseContent);
         const isStop = isStopResponse(responseContent);
@@ -2848,11 +2872,14 @@ Output ONLY the continuation, starting immediately after the last character abov
             accumulatedState = withContextRoutingValues((await runtime.composeState(message, ["RECENT_MESSAGES", "ACTION_STATE", "PROVIDERS"], false, false)), contextRoutingStateValues);
             accumulatedState.data.actionResults = traceActionResult;
             // Use dynamicPromptExecFromState for structured decision output
+            const optimizedPlannerService = runtime.getService(OPTIMIZED_PROMPT_SERVICE);
+            const baselinePlannerTemplate = runtime.character.templates?.multiStepDecisionTemplate ||
+                multiStepDecisionTemplate;
+            const resolvedPlannerTemplate = resolveOptimizedPrompt(optimizedPlannerService, "action_planner", baselinePlannerTemplate);
             const parsedStep = await runtime.dynamicPromptExecFromState({
                 state: accumulatedState,
                 params: {
-                    prompt: runtime.character.templates?.multiStepDecisionTemplate ||
-                        multiStepDecisionTemplate,
+                    prompt: resolvedPlannerTemplate,
                     ...(promptAttachments ? { attachments: promptAttachments } : {}),
                 },
                 schema: [