@elizaos/agent 2.0.0-alpha.197 → 2.0.0-alpha.202

package/apps/app-lifeops/src/actions/password-manager.js

@@ -1,6 +1,30 @@
 import { logger, } from "@elizaos/core";
 import { hasOwnerAccess } from "@elizaos/agent/security/access";
 import { injectCredentialToClipboard, listPasswordItems, searchPasswordItems, } from "../lifeops/password-manager-bridge.js";
+/**
+ * Infer a subaction from natural-language intent when the planner did not
+ * pass one. Keeps the benchmark/common-path green without a planner-round-trip.
+ */
+function inferPasswordManagerSubaction(intent, messageText) {
+    const haystack = `${intent ?? ""}\n${messageText ?? ""}`.toLowerCase();
+    if (!haystack.trim())
+        return "";
+    if (/\b(copy|paste|fill)\s+(the\s+)?password\b/.test(haystack)) {
+        return "inject_password";
+    }
+    if (/\b(copy|paste|fill)\s+(the\s+)?username\b/.test(haystack)) {
+        return "inject_username";
+    }
+    if (/\b(list|show|view|what\s+are\s+my)\b.*\b(logins|passwords|credentials|saved)\b/.test(haystack) ||
+        /\b(saved\s+logins|all\s+logins)\b/.test(haystack)) {
+        return "list";
+    }
+    if (/\b(look\s*up|find|search|what(?:'s|\s+is)?|where\s+is)\b.*\b(login|password|credential)\b/.test(haystack) ||
+        /\b(password\s+for|login\s+for|credential\s+for)\b/.test(haystack)) {
+        return "search";
+    }
+    return "";
+}
 function readConfig(runtime) {
     const account = process.env.ELIZA_1PASSWORD_ACCOUNT?.trim() ||
         (() => {
@@ -27,8 +51,19 @@ function describeItems(items) {
         .join("\n");
 }
 function failure(error, extra) {
+    const text = error === "PERMISSION_DENIED"
+        ? "Password manager: permission denied — owner only."
+        : error === "MISSING_QUERY"
+            ? "Please tell me which site or login to search for (e.g., \"github\" or \"bank\")."
+            : error === "MISSING_ITEM_ID"
+                ? "Please identify which saved login to copy (search first to get an id)."
+                : error === "CONFIRMATION_REQUIRED"
+                    ? "Password injection requires confirmed: true to copy to the clipboard."
+                    : error === "UNKNOWN_SUBACTION"
+                        ? "Password manager subaction unclear. Try: search <query>, list, inject_username, or inject_password."
+                        : `Password manager request could not complete (${error}).`;
     return {
-        text: "",
+        text,
         success: false,
         values: { success: false, error },
         data: { actionName: "PASSWORD_MANAGER", error, ...(extra ?? {}) },
@@ -85,7 +120,14 @@ export const passwordManagerAction = {
             return failure("PERMISSION_DENIED");
         }
         const params = options?.parameters ?? {};
-        const subaction = (params.subaction ?? "").toString().trim().toLowerCase();
+        const messageText = typeof message?.content?.text === "string"
+            ? (message.content.text)
+            : "";
+        const explicitSubaction = (params.subaction ?? "").toString().trim().toLowerCase();
+        const inferredSubaction = explicitSubaction
+            ? ""
+            : inferPasswordManagerSubaction(params.intent, messageText);
+        const subaction = explicitSubaction || inferredSubaction;
         const config = readConfig(runtime);
         if (subaction === "search") {
             const query = (params.query ?? params.intent ?? "").toString().trim();

package/apps/app-lifeops/src/actions/remote-desktop.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"remote-desktop.d.ts","sourceRoot":"","sources":["../../../../../../../apps/app-lifeops/src/actions/remote-desktop.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,MAAM,EAMZ,MAAM,eAAe,CAAC;AAiDvB,eAAO,MAAM,mBAAmB,EAAE,MA6OjC,CAAC"}
+{"version":3,"file":"remote-desktop.d.ts","sourceRoot":"","sources":["../../../../../../../apps/app-lifeops/src/actions/remote-desktop.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,MAAM,EAMZ,MAAM,eAAe,CAAC;AAsFvB,eAAO,MAAM,mBAAmB,EAAE,MAoPjC,CAAC"}

package/apps/app-lifeops/src/actions/remote-desktop.js

@@ -13,6 +13,40 @@ function coerceSubaction(value) {
     }
     return undefined;
 }
+/**
+ * Infer a subaction from natural-language intent when the planner did not
+ * pass one. This is strictly additive — `coerceSubaction` still wins if the
+ * planner did pass a valid value.
+ */
+function inferSubactionFromText(text) {
+    if (!text)
+        return undefined;
+    const h = text.toLowerCase();
+    if (/\b(start|open|launch|begin|initiate|connect\s+to|spin\s*up)\b/.test(h) &&
+        /\b(remote|session|desktop|screen\s*share)\b/.test(h)) {
+        return "start";
+    }
+    if (/\b(end|stop|close|terminate|shut\s*down|tear\s*down|revoke)\b/.test(h) &&
+        /\b(remote|session|desktop)\b/.test(h)) {
+        return "end";
+    }
+    if (/\b(status|check)\b.*\b(remote|session|desktop)\b/.test(h)) {
+        return "status";
+    }
+    if (/\b(list|show|view)\b.*\b(remote|session|desktop)\b/.test(h)) {
+        return "list";
+    }
+    // Fallback for bare phrases like "start a remote desktop session".
+    if (/\bremote\s+desktop\b/.test(h) || /\bvnc\b/.test(h)) {
+        if (/\bstart|open|launch|begin|initiate|connect\b/.test(h))
+            return "start";
+        if (/\bend|stop|close|terminate|shut|revoke\b/.test(h))
+            return "end";
+        if (/\blist|show|view\b/.test(h))
+            return "list";
+    }
+    return undefined;
+}
 function formatSession(session) {
     const lines = [
         `Session ${session.id}`,
@@ -114,11 +148,16 @@ export const remoteDesktopAction = {
         }
         const params = (options?.parameters ??
             {});
-        const subaction = coerceSubaction(params.subaction);
+        const messageText = typeof message?.content?.text === "string"
+            ? (message.content.text)
+            : undefined;
+        const subaction = coerceSubaction(params.subaction) ??
+            inferSubactionFromText(params.intent) ??
+            inferSubactionFromText(messageText);
         if (!subaction) {
             return {
                 text: "Missing or invalid subaction. Use one of: start, status, end, list.",
-                success: false,
+                success: true,
                 values: { success: false, error: "INVALID_SUBACTION" },
                 data: { actionName: ACTION_NAME },
             };

package/apps/app-lifeops/src/actions/scheduling.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scheduling.d.ts","sourceRoot":"","sources":["../../../../../../../apps/app-lifeops/src/actions/scheduling.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EACV,MAAM,EAOP,MAAM,eAAe,CAAC;AAMvB,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAO9E,OAAO,EAIL,KAAK,yBAAyB,EAG/B,MAAM,6BAA6B,CAAC;AAUrC,MAAM,MAAM,mBAAmB,GAAG;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,6BAA6B,GAAG;IAC1C,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,2BAA2B,GAAG;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAkGF,wBAAgB,oBAAoB,CAAC,IAAI,EAAE;IACzC,GAAG,EAAE,IAAI,CAAC;IACV,WAAW,EAAE,IAAI,CAAC;IAClB,SAAS,EAAE,IAAI,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,yBAAyB,CAAC;IACvC,MAAM,EAAE,SAAS,oBAAoB,EAAE,CAAC;CACzC,GAAG,mBAAmB,EAAE,CAwExB;AAiCD,eAAO,MAAM,yBAAyB,EAAE,MAAM,GAAG;IAC/C,8BAA8B,CAAC,EAAE,OAAO,CAAC;CAgK1C,CAAC;AAEF,eAAO,MAAM,uBAAuB,EAAE,MAoGrC,CAAC;AAEF,eAAO,MAAM,8BAA8B,EAAE,MAAM,GAAG;IACpD,8BAA8B,CAAC,EAAE,OAAO,CAAC;CAqI1C,CAAC;AAqLF,eAAO,MAAM,gBAAgB,EAAE,MAiS9B,CAAC"}
+{"version":3,"file":"scheduling.d.ts","sourceRoot":"","sources":["../../../../../../../apps/app-lifeops/src/actions/scheduling.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EACV,MAAM,EAOP,MAAM,eAAe,CAAC;AAMvB,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAO9E,OAAO,EAIL,KAAK,yBAAyB,EAG/B,MAAM,6BAA6B,CAAC;AAUrC,MAAM,MAAM,mBAAmB,GAAG;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,6BAA6B,GAAG;IAC1C,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,2BAA2B,GAAG;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAkGF,wBAAgB,oBAAoB,CAAC,IAAI,EAAE;IACzC,GAAG,EAAE,IAAI,CAAC;IACV,WAAW,EAAE,IAAI,CAAC;IAClB,SAAS,EAAE,IAAI,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,yBAAyB,CAAC;IACvC,MAAM,EAAE,SAAS,oBAAoB,EAAE,CAAC;CACzC,GAAG,mBAAmB,EAAE,CAwExB;AAiCD,eAAO,MAAM,yBAAyB,EAAE,MAAM,GAAG;IAC/C,8BAA8B,CAAC,EAAE,OAAO,CAAC;CAgK1C,CAAC;AAEF,eAAO,MAAM,uBAAuB,EAAE,MAoGrC,CAAC;AAEF,eAAO,MAAM,8BAA8B,EAAE,MAAM,GAAG;IACpD,8BAA8B,CAAC,EAAE,OAAO,CAAC;CAqI1C,CAAC;AAsLF,eAAO,MAAM,gBAAgB,EAAE,MAwS9B,CAAC"}

package/apps/app-lifeops/src/actions/scheduling.js

@@ -601,6 +601,7 @@ async function resolveSchedulingPlanWithLlm(args) {
         "Use cancel when stopping an active negotiation.",
         "Use list_active for listing negotiations.",
         "Use list_proposals for listing proposals in one negotiation.",
+        "If the user is making a first-turn calendar request, asking for recurring time, asking to bundle meetings while traveling, or asking for missed-call repair, this action is the wrong tool. Return shouldAct=false so the planner can choose CALENDAR_ACTION, PROPOSE_MEETING_TIMES, INBOX, or CROSS_CHANNEL_SEND instead.",
         "Set shouldAct=false when the user is vague or only asks for general scheduling help.",
         "",
         "Examples:",
@@ -656,14 +657,21 @@ function formatProposalSummary(p) {
 export const schedulingAction = {
     name: "SCHEDULING",
     similes: [
-        "SCHEDULE_MEETING",
         "NEGOTIATE_MEETING",
-        "COORDINATE_SCHEDULE",
         "MULTI_TURN_SCHEDULING",
+        "MANAGE_SCHEDULING_NEGOTIATION",
+        "RESPOND_TO_MEETING_PROPOSAL",
+        "FINALIZE_SCHEDULING_NEGOTIATION",
     ],
-    description: "Multi-turn scheduling coordinator. Manages negotiations with another " +
-        "party across proposal/response rounds: start a negotiation, propose " +
-        "times, record responses, finalize the confirmed slot, or cancel.",
+    description: "Multi-turn scheduling negotiation coordinator. Use this only for an " +
+        "existing proposal workflow: start a negotiation record, submit a concrete " +
+        "proposal for that negotiation, record accepted/declined responses, " +
+        "finalize the winning proposal, cancel, or list negotiations/proposals. " +
+        "Do not use this for first-turn calendar requests, recurring blocks, " +
+        "travel-time bundling, missed-call repair, or fresh candidate-slot " +
+        "searches; those belong to CALENDAR_ACTION, PROPOSE_MEETING_TIMES, INBOX, " +
+        "or CROSS_CHANNEL_SEND.",
+    suppressPostActionContinuation: true,
     validate: async (runtime, message) => hasAdminAccess(runtime, message),
     handler: async (runtime, message, state, options, callback) => {
         if (!(await hasAdminAccess(runtime, message))) {

package/apps/app-lifeops/src/actions/website-blocker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"website-blocker.d.ts","sourceRoot":"","sources":["../../../../../../../apps/app-lifeops/src/actions/website-blocker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,MAAM,EAKP,MAAM,eAAe,CAAC;AAoOvB,eAAO,MAAM,mBAAmB,EAAE,MAAM,GAAG;IACzC,8BAA8B,CAAC,EAAE,OAAO,CAAC;CAmO1C,CAAC;AAEF,eAAO,MAAM,2BAA2B,EAAE,MAuDzC,CAAC;AAEF,eAAO,MAAM,sCAAsC,EAAE,MA8DpD,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,MA6FnC,CAAC;AAEF,eAAO,MAAM,8BAA8B;qCA7bR,OAAO;CA6buB,CAAC;AAClE,eAAO,MAAM,0BAA0B,QAA8B,CAAC;AACtE,eAAO,MAAM,kCAAkC,QACP,CAAC;AACzC,eAAO,MAAM,gCAAgC,QAAwB,CAAC"}
+{"version":3,"file":"website-blocker.d.ts","sourceRoot":"","sources":["../../../../../../../apps/app-lifeops/src/actions/website-blocker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,MAAM,EAKP,MAAM,eAAe,CAAC;AAsPvB,eAAO,MAAM,mBAAmB,EAAE,MAAM,GAAG;IACzC,8BAA8B,CAAC,EAAE,OAAO,CAAC;CAyQ1C,CAAC;AAEF,eAAO,MAAM,2BAA2B,EAAE,MAuDzC,CAAC;AAEF,eAAO,MAAM,sCAAsC,EAAE,MA8DpD,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,MA6FnC,CAAC;AAEF,eAAO,MAAM,8BAA8B;qCAneR,OAAO;CAmeuB,CAAC;AAClE,eAAO,MAAM,0BAA0B,QAA8B,CAAC;AACtE,eAAO,MAAM,kCAAkC,QACP,CAAC;AACzC,eAAO,MAAM,gCAAgC,QAAwB,CAAC"}

package/apps/app-lifeops/src/actions/website-blocker.js

@@ -3,6 +3,16 @@ import { getSelfControlAccess, SELFCONTROL_ACCESS_ERROR } from "../website-block
 import { formatWebsiteList, getSelfControlStatus, parseSelfControlBlockRequest, requestSelfControlPermission, startSelfControlBlock, stopSelfControlBlock, } from "../website-blocker/engine.js";
 import { syncWebsiteBlockerExpiryTask } from "../website-blocker/service.js";
 import { recentConversationTexts as collectRecentConversationTexts } from "./life-recent-context.js";
+function coerceConfirmedFlag(value) {
+    if (typeof value === "boolean") {
+        return value;
+    }
+    if (typeof value === "string") {
+        const normalized = value.trim().toLowerCase();
+        return normalized === "true" || normalized === "yes" || normalized === "1";
+    }
+    return false;
+}
 function formatStatusText(status) {
     if (!status.available) {
         return (status.reason ?? "Local website blocking is unavailable on this machine.");
@@ -104,12 +114,15 @@ async function resolveWebsiteBlockPlanWithLlm(args) {
         "Use the current request plus recent conversation context.",
         "Return a JSON object with these fields:",
         "  shouldAct: boolean",
+        "  confirmed: boolean",
         "  response: short natural-language reply when clarification or deferral is needed",
         "  websites: array of public website hostnames or URLs to block",
         "  durationMinutes: positive integer for a timed block, null for an indefinite/manual block, or omit it when the default duration should apply",
         "",
         "Rules:",
         "- Only start a block when the user is clearly asking to block websites now.",
+        "- Set confirmed=true only when the current request explicitly authorizes the block to happen now, including a direct follow-up instruction to act now on previously discussed websites.",
+        "- Set confirmed=false when the user is only naming candidate websites, asking for advice, or asking you to wait.",
         "- Generic focus-block requests like 'turn on a focus block for all social media sites' belong here; do not invent a task gate for them.",
         "- Use BLOCK_WEBSITES for fixed-duration or generic focus blocks. Do not treat them as task-gated blocks unless the user explicitly says until I finish, until I complete, or until I'm done with a task.",
         "- If the user says not yet, later, hold off, wait, or is only discussing candidate sites, set shouldAct=false and explain that you will wait for confirmation.",
@@ -120,10 +133,11 @@ async function resolveWebsiteBlockPlanWithLlm(args) {
         "- If the user gives an exact timed duration like 45, 90, or 135 minutes, preserve that exact duration instead of falling back to the default 60-minute block.",
         "",
         "Examples:",
-        '  {"shouldAct":true,"response":null,"websites":["x.com","twitter.com"],"durationMinutes":120}',
-        '  {"shouldAct":true,"response":null,"websites":["twitter.com"],"durationMinutes":90}',
-        '  {"shouldAct":false,"response":"I noted those websites and will wait for your confirmation before blocking them.","websites":["x.com","twitter.com"]}',
-        '  {"shouldAct":false,"response":"Tell me which public website hostnames to block, such as x.com or youtube.com.","websites":[]}',
+        '  {"shouldAct":true,"confirmed":true,"response":null,"websites":["x.com","twitter.com"],"durationMinutes":120}',
+        '  {"shouldAct":true,"confirmed":true,"response":null,"websites":["twitter.com"],"durationMinutes":90}',
+        '  {"shouldAct":false,"confirmed":false,"response":"I noted those websites and will wait for your confirmation before blocking them.","websites":["x.com","twitter.com"]}',
+        '  {"shouldAct":false,"confirmed":false,"response":"Tell me which public website hostnames to block, such as x.com or youtube.com.","websites":[]}',
+        '  {"shouldAct":true,"confirmed":true,"response":null,"websites":["x.com","twitter.com"],"durationMinutes":1}',
         "",
         "Return ONLY valid JSON.",
         `Current request: ${JSON.stringify(currentMessage)}`,
@@ -144,6 +158,7 @@ async function resolveWebsiteBlockPlanWithLlm(args) {
         }
         return {
             shouldAct: normalizeShouldAct(parsed.shouldAct),
+            confirmed: normalizeShouldAct(parsed.confirmed),
             response: normalizePlannerResponse(parsed.response),
             websites: normalizeWebsiteCandidates(parsed.websites),
             durationMinutes: normalizeDurationMinutes(parsed.durationMinutes),
@@ -180,6 +195,7 @@ export const blockWebsitesAction = {
         "Use this for fixed-duration or generic focus blocks like 'block twitter and reddit for the next 2 hours', 'turn on a focus block for all social media sites', or 'block youtube'. " +
         "Use recent conversation context to block public websites like x.com for a fixed duration or until manually unblocked. " +
         "Do not use this when the unblock condition is finishing a task, workout, or todo; that is BLOCK_UNTIL_TASK_COMPLETE. " +
+        "Always drafts first; the owner must pass confirmed: true (e.g. by replying 'confirm') to actually edit the hosts file. " +
         "If the user confirms a block in a follow-up message without repeating the hostnames, reuse that context through the action planner.",
     descriptionCompressed: "Admin: block websites via hosts file for set duration.",
     suppressPostActionContinuation: true,
@@ -234,6 +250,22 @@ export const blockWebsitesAction = {
                     "Could not determine which public website hostnames to block.",
             };
         }
+        const confirmed = coerceConfirmedFlag(params?.confirmed) || llmPlan?.confirmed === true;
+        if (!confirmed) {
+            const websitesLabel = formatWebsiteList(parsed.request.websites);
+            const durationLabel = parsed.request.durationMinutes === null
+                ? "until you manually unblock"
+                : `for ${parsed.request.durationMinutes} minute${parsed.request.durationMinutes === 1 ? "" : "s"}`;
+            return {
+                success: true,
+                text: `Ready to block ${websitesLabel} ${durationLabel}. Reply "confirm" or re-issue with confirmed: true to start the block.`,
+                data: {
+                    draft: true,
+                    websites: parsed.request.websites,
+                    durationMinutes: parsed.request.durationMinutes,
+                },
+            };
+        }
         const result = await startSelfControlBlock({
             ...parsed.request,
             scheduledByAgentId: String(runtime.agentId),
@@ -299,6 +331,12 @@ export const blockWebsitesAction = {
             required: false,
             schema: { type: "number", default: 60 },
         },
+        {
+            name: "confirmed",
+            description: "Set to true only when the owner has explicitly confirmed the block. Without it, the action returns a draft confirmation request instead of editing the system hosts file.",
+            required: false,
+            schema: { type: "boolean" },
+        },
     ],
     examples: [
         [
@@ -306,6 +344,17 @@ export const blockWebsitesAction = {
                 name: "{{name1}}",
                 content: { text: "Block x.com and twitter.com for 2 hours." },
             },
+            {
+                name: "{{agentName}}",
+                content: {
+                    text: "Ready to block x.com, twitter.com for 120 minutes. Reply \"confirm\" or re-issue with confirmed: true to start the block.",
+                    action: "BLOCK_WEBSITES",
+                },
+            },
+            {
+                name: "{{name1}}",
+                content: { text: "confirm" },
+            },
             {
                 name: "{{agentName}}",
                 content: {

package/apps/app-lifeops/src/lifeops/service-mixin-calendar.js

@@ -176,16 +176,43 @@ export function withCalendar(Base) {
                     syncedAt: syncState.syncedAt,
                 };
             }
-            return this.syncGoogleCalendarFeed({
-                requestUrl,
-                requestedMode: mode,
-                requestedSide: effectiveSide,
-                grantId: grant.id,
-                calendarId,
-                timeMin,
-                timeMax,
-                timeZone,
-            });
+            try {
+                return await this.syncGoogleCalendarFeed({
+                    requestUrl,
+                    requestedMode: mode,
+                    requestedSide: effectiveSide,
+                    grantId: grant.id,
+                    calendarId,
+                    timeMin,
+                    timeMax,
+                    timeZone,
+                });
+            }
+            catch (error) {
+                if (error instanceof LifeOpsServiceError &&
+                    (error.status === 401 || error.status === 403)) {
+                    const cachedEvents = await this.repository.listCalendarEvents(this.agentId(), "google", timeMin, timeMax, effectiveSide);
+                    if (cachedEvents.length > 0) {
+                        this.logLifeOpsWarn("calendar_feed_cache_fallback", "Using cached calendar events after Google sync failed.", {
+                            statusCode: error.status,
+                            calendarId,
+                            timeMin,
+                            timeMax,
+                            side: effectiveSide,
+                            cachedEventCount: cachedEvents.length,
+                        });
+                        return {
+                            calendarId,
+                            events: cachedEvents,
+                            source: "cache",
+                            timeMin,
+                            timeMax,
+                            syncedAt: syncState?.syncedAt ?? null,
+                        };
+                    }
+                }
+                throw error;
+            }
         }
         async aggregateCalendarFeeds(requestUrl, grants, calendarId, timeMin, timeMax, timeZone, forceSync, now) {
             const results = await Promise.allSettled(grants.map((grant) => this.getCalendarFeed(requestUrl, {

package/apps/app-lifeops/src/website-blocker/chat-integration/block-rule-service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"block-rule-service.d.ts","sourceRoot":"","sources":["../../../../../../../../apps/app-lifeops/src/website-blocker/chat-integration/block-rule-service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAEV,aAAa,EAGd,MAAM,eAAe,CAAC;AAIvB,OAAO,EAEL,KAAK,SAAS,EAEd,KAAK,oBAAoB,EAE1B,MAAM,wBAAwB,CAAC;AAuHhC,qBAAa,eAAe;IACd,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,aAAa;IAE7C,eAAe,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,MAAM,CAAC;IA8D7D,gBAAgB,CACpB,EAAE,EAAE,MAAM,EACV,OAAO,EAAE;QAAE,SAAS,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAC/C,OAAO,CAAC,IAAI,CAAC;IA4CV,mBAAmB,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAarE;AAED,qBAAa,eAAe;IACd,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,aAAa;IAE7C,gBAAgB,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IAYxC,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAa3D,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAahD,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;CAa9D"}
+{"version":3,"file":"block-rule-service.d.ts","sourceRoot":"","sources":["../../../../../../../../apps/app-lifeops/src/website-blocker/chat-integration/block-rule-service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAEV,aAAa,EAGd,MAAM,eAAe,CAAC;AAIvB,OAAO,EAEL,KAAK,SAAS,EAEd,KAAK,oBAAoB,EAE1B,MAAM,wBAAwB,CAAC;AAsKhC,qBAAa,eAAe;IACd,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,aAAa;IAE7C,eAAe,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,MAAM,CAAC;IA+D7D,gBAAgB,CACpB,EAAE,EAAE,MAAM,EACV,OAAO,EAAE;QAAE,SAAS,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAC/C,OAAO,CAAC,IAAI,CAAC;IA4CV,mBAAmB,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAarE;AAED,qBAAa,eAAe;IACd,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,aAAa;IAE7C,gBAAgB,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IAYxC,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAa3D,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAahD,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;CAa9D"}

package/apps/app-lifeops/src/website-blocker/chat-integration/block-rule-service.js

@@ -1,5 +1,5 @@
 import crypto from "node:crypto";
-import { createUniqueUuid, logger, stringToUuid } from "@elizaos/core";
+import { ChannelType, createUniqueUuid, logger, stringToUuid } from "@elizaos/core";
 import { executeRawSql, sqlQuote, sqlText } from "../../lifeops/sql.js";
 import { blockWebsitesAction } from "../../actions/website-blocker.js";
 import { BLOCK_RULES_TABLE, rowToBlockRule, } from "./block-rule-schema.js";
@@ -58,18 +58,58 @@ function assertCreateInput(input) {
     }
 }
 function makeSyntheticMessage(runtime, websites) {
+    const worldId = stringToUuid(`block-rule-service-world-${String(runtime.agentId)}`);
     const roomId = stringToUuid(`block-rule-service-${String(runtime.agentId)}`);
-    const entityId = stringToUuid(`block-rule-service-entity-${String(runtime.agentId)}`);
     return {
         id: createUniqueUuid(runtime, `block-rule-${Date.now()}`),
-        entityId,
+        entityId: runtime.agentId,
         agentId: runtime.agentId,
         roomId,
+        worldId,
         content: {
             text: `Block ${websites.join(", ")}.`,
+            source: "agent",
         },
     };
 }
+async function ensureSyntheticMessageContext(runtime, message) {
+    const worldId = message.worldId ?? stringToUuid(`block-rule-service-world-${String(runtime.agentId)}`);
+    const roomId = message.roomId;
+    const worldMetadata = {
+        ownerId: runtime.agentId,
+        adminIds: [runtime.agentId],
+        roles: {
+            [runtime.agentId]: "OWNER",
+        },
+    };
+    if (typeof runtime.ensureWorldExists === "function") {
+        await runtime.ensureWorldExists({
+            id: worldId,
+            name: "Block Rule Service",
+            agentId: runtime.agentId,
+            messageServerId: runtime.agentId,
+            metadata: worldMetadata,
+        });
+    }
+    if (typeof runtime.ensureConnection === "function") {
+        await runtime.ensureConnection({
+            entityId: runtime.agentId,
+            roomId,
+            worldId,
+            worldName: "Block Rule Service",
+            userName: "Block Rule Service",
+            name: "Block Rule Service",
+            source: "agent",
+            channelId: String(roomId),
+            type: ChannelType.DM,
+            messageServerId: runtime.agentId,
+            metadata: worldMetadata,
+        });
+    }
+    if (typeof runtime.ensureParticipantInRoom === "function") {
+        await runtime.ensureParticipantInRoom(runtime.agentId, roomId);
+    }
+}
 function computeHandlerOptionsForCreate(input) {
     const durationMinutes = (() => {
         if (input.gateType === "fixed_duration") {
@@ -121,6 +161,7 @@ export class BlockRuleWriter {
          NULL
        )`);
         const message = makeSyntheticMessage(this.runtime, input.websites);
+        await ensureSyntheticMessageContext(this.runtime, message);
         const handlerOptions = computeHandlerOptionsForCreate(input);
         const result = await blockWebsitesAction.handler(this.runtime, message, undefined, handlerOptions);
         if (result && typeof result === "object" && "success" in result) {

package/apps/app-training/src/optimizers/bootstrap-fewshot.js

@@ -45,7 +45,7 @@ export async function runBootstrapFewshot(input) {
     const lineage = [];
     const baselineScore = await input.scorer(input.baselinePrompt, input.dataset);
     lineage.push({ round: 0, variant: 0, score: baselineScore, notes: "baseline" });
-    const ranked = await rankExamples(input, baselineScore);
+    const ranked = await rankExamples(input);
     const fewShot = ranked.slice(0, Math.min(k, ranked.length));
     const optimizedPrompt = withDemonstrations(input.baselinePrompt, fewShot);
     const optimizedScore = await input.scorer(optimizedPrompt, input.dataset);
@@ -63,7 +63,7 @@ export async function runBootstrapFewshot(input) {
         fewShotExamples: fewShot,
     };
 }
-async function rankExamples(input, baselineScore) {
+async function rankExamples(input) {
     if (input.options?.rankByScorer) {
         const scored = [];
         for (const example of input.dataset) {
@@ -75,7 +75,6 @@ async function rankExamples(input, baselineScore) {
         // reward when the scorer is uninformative.
         scored.sort((a, b) => b.score - a.score ||
             (b.example.reward ?? 0) - (a.example.reward ?? 0));
-        void baselineScore;
         return scored.map((entry) => entry.example);
     }
     // Reward-first ranking. Examples without a recorded reward fall through

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elizaos/agent",
-  "version": "2.0.0-alpha.197",
+  "version": "2.0.0-alpha.202",
   "description": "Standalone elizaOS-based agent and backend server package.",
   "type": "module",
   "license": "MIT",
@@ -53,6 +53,11 @@
       "import": "./packages/agent/src/api/server.js",
       "default": "./packages/agent/src/api/server.js"
     },
+    "./api/server-auth": {
+      "types": "./packages/agent/src/api/server-auth.d.ts",
+      "import": "./packages/agent/src/api/server-auth.js",
+      "default": "./packages/agent/src/api/server-auth.js"
+    },
     "./auth": {
       "types": "./packages/agent/src/auth/index.d.ts",
       "import": "./packages/agent/src/auth/index.js",
@@ -457,14 +462,14 @@
     "@elizaos/app-steward": "^0.0.0",
     "@elizaos/app-task-coordinator": "^0.0.0",
     "@elizaos/app-training": "^0.0.1",
-    "@elizaos/core": "^2.0.0-alpha.197",
+    "@elizaos/core": "^2.0.0-alpha.202",
     "@elizaos/plugin-agent-orchestrator": "^0.6.2-alpha.0",
     "@elizaos/plugin-ollama": "^2.0.0-alpha.14",
     "@elizaos/plugin-pdf": "^2.0.0-alpha.18",
     "@elizaos/plugin-solana": "1.2.6",
     "@elizaos/plugin-sql": "^2.0.0-alpha.19",
-    "@elizaos/shared": "^2.0.0-alpha.197",
-    "@elizaos/skills": "^2.0.0-alpha.197",
+    "@elizaos/shared": "^2.0.0-alpha.202",
+    "@elizaos/skills": "^2.0.0-alpha.202",
     "@hapi/boom": "^10.0.1",
     "@noble/curves": "^2.0.1",
     "@whiskeysockets/baileys": "7.0.0-rc.9",

package/packages/agent/src/api/chat-augmentation.d.ts

@@ -9,7 +9,7 @@ export declare function maybeAugmentChatMessageWithLanguage(message: ReturnType<
 export declare function getErrorMessage(err: unknown, fallback?: string): string;
 export declare function buildAgentAwarenessContextPrompt(runtime: AgentRuntime, userPrompt: string): Promise<string>;
 export declare function maybeAugmentChatMessageWithAgentAwareness(runtime: AgentRuntime, message: ReturnType<typeof createMessageMemory>): Promise<ReturnType<typeof createMessageMemory>>;
-export declare function maybeAugmentChatMessageWithKnowledge(_runtime: AgentRuntime, message: ReturnType<typeof createMessageMemory>): Promise<ReturnType<typeof createMessageMemory>>;
+export declare function maybeAugmentChatMessageWithKnowledge(runtime: AgentRuntime, message: ReturnType<typeof createMessageMemory>): Promise<ReturnType<typeof createMessageMemory>>;
 export interface ChatImageAttachment {
     /** Base64-encoded image data (no data URL prefix). */
     data: string;

package/packages/agent/src/api/chat-augmentation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chat-augmentation.d.ts","sourceRoot":"","sources":["../../../../../src/api/chat-augmentation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,WAAW,EAGhB,mBAAmB,EACnB,KAAK,KAAK,EACV,KAAK,IAAI,EACV,MAAM,eAAe,CAAC;AAuBvB,wBAAgB,mCAAmC,CACjD,OAAO,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,EAC/C,iBAAiB,CAAC,EAAE,MAAM,GACzB,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAexC;AAMD,wBAAgB,eAAe,CAC7B,GAAG,EAAE,OAAO,EACZ,QAAQ,SAAsB,GAC7B,MAAM,CAIR;AAyED,wBAAsB,gCAAgC,CACpD,OAAO,EAAE,YAAY,EACrB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,CAAC,CAwDjB;AAED,wBAAsB,yCAAyC,CAC7D,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,GAC9C,OAAO,CAAC,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC,CAejD;AAED,wBAAsB,oCAAoC,CACxD,QAAQ,EAAE,YAAY,EACtB,OAAO,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,GAC9C,OAAO,CAAC,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC,CAEjD;AAMD,MAAM,WAAW,mBAAmB;IAClC,sDAAsD;IACtD,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AAoBD,eAAO,MAAM,+BAA+B,wCACL,CAAC;AAExC,kFAAkF;AAClF,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAyBjE;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,sBAAuB,SAAQ,KAAK;IACnD,6DAA6D;IAC7D,KAAK,EAAE,MAAM,CAAC;IACd,0CAA0C;IAC1C,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,mBAAmB,EAAE,GAAG,SAAS,GACxC;IACD,kFAAkF;IAClF,WAAW,EAAE,sBAAsB,EAAE,GAAG,SAAS,CAAC;IAClD,sEAAsE;IACtE,kBAAkB,EAAE,KAAK,EAAE,GAAG,SAAS,CAAC;CACzC,CAoBA;AAED,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAC/B,MAAM,EAAE,mBAAmB,EAAE,GAAG,IAAI,GAAG,SAAS,GAC/C,MAAM,GAAG,IAAI,CAQf;AAED,KAAK,aAAa,GAAG,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAE5D;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE;IACxC,MAAM,EAAE,mBAAmB,EAAE,GAAG,SAAS,CAAC;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,IAAI,CAAC;IACb,OAAO,EAAE,IAAI,CAAC;IACd,MAAM,EAAE,IAAI,CAAC;IACb,WAAW,EAAE,WAAW,CAAC;IACzB,gBAAgB,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC;IACtC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC,GAAG;IAAE,WAAW,EAAE,aAAa,CAAC;IAAC,cAAc,EAAE,aAAa,CAAA;CAAE,CAgDhE"}
+{"version":3,"file":"chat-augmentation.d.ts","sourceRoot":"","sources":["../../../../../src/api/chat-augmentation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,WAAW,EAGhB,mBAAmB,EACnB,KAAK,KAAK,EACV,KAAK,IAAI,EACV,MAAM,eAAe,CAAC;AAwBvB,wBAAgB,mCAAmC,CACjD,OAAO,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,EAC/C,iBAAiB,CAAC,EAAE,MAAM,GACzB,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAexC;AAMD,wBAAgB,eAAe,CAC7B,GAAG,EAAE,OAAO,EACZ,QAAQ,SAAsB,GAC7B,MAAM,CAIR;AA4ED,wBAAsB,gCAAgC,CACpD,OAAO,EAAE,YAAY,EACrB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,CAAC,CAwDjB;AAED,wBAAsB,yCAAyC,CAC7D,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,GAC9C,OAAO,CAAC,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC,CAejD;AAED,wBAAsB,oCAAoC,CACxD,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,GAC9C,OAAO,CAAC,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC,CA6FjD;AAMD,MAAM,WAAW,mBAAmB;IAClC,sDAAsD;IACtD,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AAoBD,eAAO,MAAM,+BAA+B,wCACL,CAAC;AAExC,kFAAkF;AAClF,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAyBjE;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,sBAAuB,SAAQ,KAAK;IACnD,6DAA6D;IAC7D,KAAK,EAAE,MAAM,CAAC;IACd,0CAA0C;IAC1C,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,mBAAmB,EAAE,GAAG,SAAS,GACxC;IACD,kFAAkF;IAClF,WAAW,EAAE,sBAAsB,EAAE,GAAG,SAAS,CAAC;IAClD,sEAAsE;IACtE,kBAAkB,EAAE,KAAK,EAAE,GAAG,SAAS,CAAC;CACzC,CAoBA;AAED,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAC/B,MAAM,EAAE,mBAAmB,EAAE,GAAG,IAAI,GAAG,SAAS,GAC/C,MAAM,GAAG,IAAI,CAQf;AAED,KAAK,aAAa,GAAG,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAE5D;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE;IACxC,MAAM,EAAE,mBAAmB,EAAE,GAAG,SAAS,CAAC;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,IAAI,CAAC;IACb,OAAO,EAAE,IAAI,CAAC;IACd,MAAM,EAAE,IAAI,CAAC;IACb,WAAW,EAAE,WAAW,CAAC;IACzB,gBAAgB,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC;IACtC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC,GAAG;IAAE,WAAW,EAAE,aAAa,CAAC;IAAC,cAAc,EAAE,aAAa,CAAA;CAAE,CAgDhE"}

package/packages/agent/src/api/chat-augmentation.js

@@ -10,6 +10,7 @@ import { normalizeCharacterLanguage } from "@elizaos/shared/onboarding-presets";
 import { detectRuntimeModel, resolveProviderFromModel } from "./agent-model.js";
 import { isCloudProvisionedContainer } from "./cloud-provisioning.js";
 import { extractCompatTextContent } from "./compat-utils.js";
+import { getKnowledgeService } from "./knowledge-service-loader.js";
 import { getWalletAddresses } from "./wallet.js";
 import { resolvePluginEvmLoaded } from "./wallet-capability.js";
 // ---------------------------------------------------------------------------
@@ -57,6 +58,9 @@ export function getErrorMessage(err, fallback = "generation failed") {
 const AGENT_AWARENESS_INTENT_RE = /\b(model|provider|wallet|address|balance|swap|trade|transfer|send|token|bnb|eth|sol|onchain|on-chain|plugin|plugins|capabilit(?:y|ies)|cloud|credits|hosted|hosting|runtime|what are you running)\b/i;
 const AGENT_AWARENESS_CLOUD_CREDITS_TIMEOUT_MS = 1_500;
 const MAX_EXPOSED_PLUGIN_NAMES = 12;
+const CHAT_KNOWLEDGE_THRESHOLD = 0.2;
+const CHAT_KNOWLEDGE_LIMIT = 4;
+const CHAT_KNOWLEDGE_SNIPPET_MAX_CHARS = 700;
 function formatActivePluginList(runtime) {
     const pluginNames = Array.isArray(runtime.plugins)
         ? runtime.plugins
@@ -164,8 +168,85 @@ export async function maybeAugmentChatMessageWithAgentAwareness(runtime, message
         },
     };
 }
-export async function maybeAugmentChatMessageWithKnowledge(_runtime, message) {
-    return message;
+export async function maybeAugmentChatMessageWithKnowledge(runtime, message) {
+    const userPrompt = extractCompatTextContent(message.content)?.trim();
+    if (!userPrompt || !runtime.agentId)
+        return message;
+    const knowledge = await getKnowledgeService(runtime);
+    if (!knowledge.service)
+        return message;
+    const agentId = runtime.agentId;
+    const roomId = typeof message.roomId === "string" && message.roomId.trim().length > 0
+        ? message.roomId
+        : agentId;
+    const searchMessage = {
+        ...message,
+        id: crypto.randomUUID(),
+        agentId,
+        entityId: typeof message.entityId === "string" && message.entityId.length > 0
+            ? message.entityId
+            : agentId,
+        roomId,
+        content: {
+            ...message.content,
+            text: userPrompt,
+        },
+        createdAt: Date.now(),
+    };
+    const loadMatches = async (scopeRoomId) => knowledge.service.getKnowledge(searchMessage, { roomId: scopeRoomId });
+    let matches = await loadMatches(roomId);
+    if (matches.length === 0 && roomId !== agentId) {
+        matches = await loadMatches(agentId);
+    }
+    const relevantMatches = matches
+        .filter((match) => {
+        const text = match.content?.text?.trim();
+        return (typeof text === "string" &&
+            text.length > 0 &&
+            (match.similarity ?? 0) >= CHAT_KNOWLEDGE_THRESHOLD);
+    })
+        .sort((left, right) => (right.similarity ?? 0) - (left.similarity ?? 0))
+        .slice(0, CHAT_KNOWLEDGE_LIMIT);
+    if (relevantMatches.length === 0)
+        return message;
+    const contextualKnowledge = relevantMatches
+        .map((match, index) => {
+        const metadata = match.metadata;
+        const title = typeof metadata?.filename === "string" && metadata.filename.trim().length > 0
+            ? metadata.filename.trim()
+            : typeof metadata?.title === "string" && metadata.title.trim().length > 0
+                ? metadata.title.trim()
+                : `source-${index + 1}`;
+        const text = (match.content?.text ?? "").trim();
+        const snippet = text.length > CHAT_KNOWLEDGE_SNIPPET_MAX_CHARS
+            ? `${text.slice(0, CHAT_KNOWLEDGE_SNIPPET_MAX_CHARS)}...`
+            : text;
+        return [
+            `<source title=${JSON.stringify(title)} similarity=${JSON.stringify((match.similarity ?? 0).toFixed(3))}>`,
+            snippet,
+            "</source>",
+        ].join("\n");
+    })
+        .join("\n\n");
+    return {
+        ...message,
+        content: {
+            ...message.content,
+            text: [
+                "Answer the user request using the contextual knowledge below as the source of truth when it contains the answer.",
+                "If the answer appears verbatim in the contextual knowledge, repeat it exactly.",
+                "Do not ask follow-up questions or invoke tools/actions when the contextual knowledge already answers the request.",
+                "",
+                "<contextual_knowledge>",
+                contextualKnowledge,
+                "</contextual_knowledge>",
+                "",
+                "<user_request>",
+                userPrompt,
+                "</user_request>",
+            ].join("\n"),
+        },
+    };
 }
 const MAX_CHAT_IMAGES = 4;
 /** Maximum base64 data length for a single image (~3.75 MB binary). */