@elizaos/agent 2.0.3-beta.2 → 2.0.3-beta.3

package/services/pending-prompts/store.d.ts

@@ -0,0 +1,70 @@
+/**
+ * `PendingPromptsStore` — backing store for open scheduled-task prompts.
+ *
+ * When a `ScheduledTask` whose `completionCheck.kind === "user_replied_within"`
+ * (or implicit `user_acknowledged`) fires, the runner records the open prompt
+ * here keyed by `roomId`. When an inbound message arrives the planner uses
+ * `list(roomId)` to decide whether to route to `complete` / `acknowledge` on
+ * the open task instead of treating it as a fresh request.
+ *
+ * Retention: open prompts are retained for `expiresAt + reopenWindowHours`
+ * (default 24h) so late inbound replies still correlate. After the reopen
+ * window the entry is purged.
+ *
+ * Backing storage: runtime cache, keyed per room. Bounded per-room slot count
+ * to defend against unbounded growth in a noisy chat.
+ */
+import type { IAgentRuntime } from "@elizaos/core";
+export type ExpectedReplyKind = "any" | "yes_no" | "approval" | "free_form";
+export interface PendingPrompt {
+    taskId: string;
+    promptSnippet: string;
+    firedAt: string;
+    expectedReplyKind: ExpectedReplyKind;
+    expiresAt?: string;
+}
+export interface PendingPromptWithRoom extends PendingPrompt {
+    roomId: string;
+}
+export interface RecordedPendingPrompt extends PendingPrompt {
+    roomId: string;
+    /**
+     * Soft-purge cut-off. After this instant the entry is no longer returned by
+     * `list()` and is dropped on the next read. Set to
+     * `expiresAt + reopenWindowHours * 3600s`, or `firedAt + 24h` when no
+     * `expiresAt` was provided.
+     */
+    retainUntilIso: string;
+}
+export interface PendingPromptRecordInput {
+    taskId: string;
+    roomId: string;
+    promptSnippet: string;
+    firedAt: string;
+    expectedReplyKind?: ExpectedReplyKind;
+    expiresAt?: string;
+    /** override the default 24h reopen window */
+    reopenWindowHours?: number;
+}
+export interface PendingPromptsStore {
+    /** Record that a task with an open prompt has fired into a room. */
+    record(input: PendingPromptRecordInput): Promise<RecordedPendingPrompt>;
+    /** List open prompts for a room. Excludes prompts past their retain window. */
+    list(roomId: string, opts?: {
+        lookbackMinutes?: number;
+        now?: Date;
+    }): Promise<PendingPrompt[]>;
+    /** List open prompts across every indexed room for UI/provider surfaces. */
+    listAll(opts?: {
+        lookbackMinutes?: number;
+        now?: Date;
+    }): Promise<PendingPromptWithRoom[]>;
+    /** Resolve a pending prompt (called when the runner records a terminal verb). */
+    resolve(roomId: string, taskId: string): Promise<void>;
+    /** Remove all entries for a task during lifecycle cleanup. */
+    forgetTask(taskId: string): Promise<void>;
+    /** Remove every recorded entry during lifecycle cleanup. */
+    clearAll(): Promise<void>;
+}
+export declare function createPendingPromptsStore(runtime: IAgentRuntime): PendingPromptsStore;
+//# sourceMappingURL=store.d.ts.map

package/services/pending-prompts/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../../src/services/pending-prompts/store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAOnD,MAAM,MAAM,iBAAiB,GAAG,KAAK,GAAG,QAAQ,GAAG,UAAU,GAAG,WAAW,CAAC;AAE5E,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB,EAAE,iBAAiB,CAAC;IACrC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,qBAAsB,SAAQ,aAAa;IAC1D,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,qBAAsB,SAAQ,aAAa;IAC1D,MAAM,EAAE,MAAM,CAAC;IACf;;;;;OAKG;IACH,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6CAA6C;IAC7C,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,mBAAmB;IAClC,oEAAoE;IACpE,MAAM,CAAC,KAAK,EAAE,wBAAwB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;IACxE,+EAA+E;IAC/E,IAAI,CACF,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE;QAAE,eAAe,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,IAAI,CAAA;KAAE,GAC9C,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;IAC5B,4EAA4E;IAC5E,OAAO,CAAC,IAAI,CAAC,EAAE;QACb,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,GAAG,CAAC,EAAE,IAAI,CAAC;KACZ,GAAG,OAAO,CAAC,qBAAqB,EAAE,CAAC,CAAC;IACrC,iFAAiF;IACjF,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvD,8DAA8D;IAC9D,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1C,4DAA4D;IAC5D,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAuED,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,aAAa,GACrB,mBAAmB,CA8JrB"}

package/services/pending-prompts/store.js

@@ -0,0 +1,191 @@
+/**
+ * `PendingPromptsStore` — backing store for open scheduled-task prompts.
+ *
+ * When a `ScheduledTask` whose `completionCheck.kind === "user_replied_within"`
+ * (or implicit `user_acknowledged`) fires, the runner records the open prompt
+ * here keyed by `roomId`. When an inbound message arrives the planner uses
+ * `list(roomId)` to decide whether to route to `complete` / `acknowledge` on
+ * the open task instead of treating it as a fresh request.
+ *
+ * Retention: open prompts are retained for `expiresAt + reopenWindowHours`
+ * (default 24h) so late inbound replies still correlate. After the reopen
+ * window the entry is purged.
+ *
+ * Backing storage: runtime cache, keyed per room. Bounded per-room slot count
+ * to defend against unbounded growth in a noisy chat.
+ */
+const PROMPT_SNIPPET_MAX_LENGTH = 120;
+const DEFAULT_REOPEN_WINDOW_HOURS = 24;
+const PER_ROOM_MAX_PROMPTS = 16;
+const ROOM_INDEX_KEY = "eliza:lifeops:pending-prompts:rooms:v1";
+function roomCacheKey(roomId) {
+    return `eliza:lifeops:pending-prompts:room:${roomId}:v1`;
+}
+function clampSnippet(value) {
+    const trimmed = value.trim();
+    if (trimmed.length <= PROMPT_SNIPPET_MAX_LENGTH) {
+        return trimmed;
+    }
+    return `${trimmed.slice(0, PROMPT_SNIPPET_MAX_LENGTH - 1).trimEnd()}…`;
+}
+function isValidIso(value) {
+    if (typeof value !== "string" || value.length === 0)
+        return false;
+    return Number.isFinite(Date.parse(value));
+}
+function computeRetainUntil(firedAt, expiresAt, reopenWindowHours) {
+    const baseMs = expiresAt ? Date.parse(expiresAt) : Date.parse(firedAt);
+    if (!Number.isFinite(baseMs)) {
+        throw new Error("[pending-prompts] cannot compute retain window");
+    }
+    const retainMs = baseMs + reopenWindowHours * 3_600_000;
+    return new Date(retainMs).toISOString();
+}
+async function loadRoom(cache, roomId) {
+    const stored = await cache.getCache(roomCacheKey(roomId));
+    return Array.isArray(stored) ? stored : [];
+}
+async function saveRoom(cache, roomId, entries) {
+    await cache.setCache(roomCacheKey(roomId), entries);
+    await registerRoom(cache, roomId);
+}
+async function registerRoom(cache, roomId) {
+    const stored = await cache.getCache(ROOM_INDEX_KEY);
+    const next = new Set(Array.isArray(stored) ? stored : []);
+    next.add(roomId);
+    await cache.setCache(ROOM_INDEX_KEY, [...next]);
+}
+async function listRooms(cache) {
+    const stored = await cache.getCache(ROOM_INDEX_KEY);
+    return Array.isArray(stored) ? stored : [];
+}
+export function createPendingPromptsStore(runtime) {
+    const cache = runtime;
+    const store = {
+        async record(input) {
+            if (!input.roomId || typeof input.roomId !== "string") {
+                throw new Error("[pending-prompts] roomId is required");
+            }
+            if (!input.taskId || typeof input.taskId !== "string") {
+                throw new Error("[pending-prompts] taskId is required");
+            }
+            if (!isValidIso(input.firedAt)) {
+                throw new Error("[pending-prompts] firedAt must be ISO-8601");
+            }
+            if (input.expiresAt !== undefined && !isValidIso(input.expiresAt)) {
+                throw new Error("[pending-prompts] expiresAt must be ISO-8601");
+            }
+            const reopenWindowHours = typeof input.reopenWindowHours === "number" &&
+                input.reopenWindowHours > 0
+                ? input.reopenWindowHours
+                : DEFAULT_REOPEN_WINDOW_HOURS;
+            const recorded = {
+                roomId: input.roomId,
+                taskId: input.taskId,
+                promptSnippet: clampSnippet(input.promptSnippet),
+                firedAt: input.firedAt,
+                expectedReplyKind: input.expectedReplyKind ?? "any",
+                retainUntilIso: computeRetainUntil(input.firedAt, input.expiresAt, reopenWindowHours),
+            };
+            if (input.expiresAt !== undefined) {
+                recorded.expiresAt = input.expiresAt;
+            }
+            const existing = await loadRoom(cache, input.roomId);
+            const filtered = existing.filter((entry) => entry.taskId !== input.taskId);
+            filtered.push(recorded);
+            // Bound per-room growth: keep newest N entries (FIFO eviction).
+            const trimmed = filtered.length > PER_ROOM_MAX_PROMPTS
+                ? filtered.slice(-PER_ROOM_MAX_PROMPTS)
+                : filtered;
+            await saveRoom(cache, input.roomId, trimmed);
+            return recorded;
+        },
+        async list(roomId, opts = {}) {
+            const now = opts.now ?? new Date();
+            const lookbackCutoffMs = typeof opts.lookbackMinutes === "number" && opts.lookbackMinutes > 0
+                ? now.getTime() - opts.lookbackMinutes * 60_000
+                : null;
+            const stored = await loadRoom(cache, roomId);
+            let mutated = false;
+            const live = [];
+            for (const entry of stored) {
+                const retainMs = Date.parse(entry.retainUntilIso);
+                if (Number.isFinite(retainMs) && retainMs <= now.getTime()) {
+                    mutated = true;
+                    continue;
+                }
+                live.push(entry);
+            }
+            if (mutated) {
+                await saveRoom(cache, roomId, live);
+            }
+            const visible = live.filter((entry) => {
+                if (lookbackCutoffMs === null)
+                    return true;
+                const firedMs = Date.parse(entry.firedAt);
+                return Number.isFinite(firedMs) && firedMs >= lookbackCutoffMs;
+            });
+            return visible
+                .slice()
+                .sort((a, b) => Date.parse(b.firedAt) - Date.parse(a.firedAt))
+                .map((entry) => {
+                const projected = {
+                    taskId: entry.taskId,
+                    promptSnippet: entry.promptSnippet,
+                    firedAt: entry.firedAt,
+                    expectedReplyKind: entry.expectedReplyKind,
+                };
+                if (entry.expiresAt !== undefined) {
+                    projected.expiresAt = entry.expiresAt;
+                }
+                return projected;
+            });
+        },
+        async listAll(opts = {}) {
+            const rooms = await listRooms(cache);
+            const perRoom = await Promise.all(rooms.map(async (roomId) => (await store.list(roomId, opts)).map((prompt) => ({
+                ...prompt,
+                roomId,
+            }))));
+            return perRoom
+                .flat()
+                .sort((a, b) => Date.parse(b.firedAt) - Date.parse(a.firedAt));
+        },
+        async resolve(roomId, taskId) {
+            const existing = await loadRoom(cache, roomId);
+            const next = existing.filter((entry) => entry.taskId !== taskId);
+            if (next.length === existing.length) {
+                return;
+            }
+            await saveRoom(cache, roomId, next);
+        },
+        async forgetTask(taskId) {
+            const rooms = await listRooms(cache);
+            for (const roomId of rooms) {
+                const existing = await loadRoom(cache, roomId);
+                const next = existing.filter((entry) => entry.taskId !== taskId);
+                if (next.length !== existing.length) {
+                    await saveRoom(cache, roomId, next);
+                }
+            }
+        },
+        async clearAll() {
+            const rooms = await listRooms(cache);
+            for (const roomId of rooms) {
+                if (typeof cache.deleteCache === "function") {
+                    await cache.deleteCache(roomCacheKey(roomId));
+                }
+                else {
+                    await cache.setCache(roomCacheKey(roomId), []);
+                }
+            }
+            if (typeof cache.deleteCache === "function") {
+                await cache.deleteCache(ROOM_INDEX_KEY);
+            }
+            else {
+                await cache.setCache(ROOM_INDEX_KEY, []);
+            }
+        },
+    };
+    return store;
+}

package/services/plugin-compiler.d.ts

@@ -1,5 +1,5 @@
 import * as esbuild from "esbuild";
-import type { VirtualFilesystemService } from "./virtual-filesystem.ts";
+import type { VirtualFilesystemService } from "./virtual-filesystem.js";
 export type PluginCompilerFormat = "esm" | "cjs";
 export interface PluginCompilerOptions {
     vfs: VirtualFilesystemService;

package/services/plugin-installer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin-installer.d.ts","sourceRoot":"","sources":["../../src/services/plugin-installer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAWH,OAAO,EAAiB,KAAK,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAU9E,uEAAuE;AACvE,eAAO,MAAM,kBAAkB,QACiB,CAAC;AAKjD,uFAAuF;AACvF,eAAO,MAAM,YAAY,QAA0B,CAAC;AAEpD,wDAAwD;AACxD,eAAO,MAAM,aAAa,QAAyC,CAAC;AAKpE,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAIzD;AAQD,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAInD;AAYD,MAAM,MAAM,YAAY,GACpB,WAAW,GACX,aAAa,GACb,iBAAiB,GACjB,YAAY,GACZ,aAAa,GACb,YAAY,GACZ,UAAU,GACV,OAAO,CAAC;AAEZ,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,YAAY,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,gBAAgB,GAAG,CAAC,QAAQ,EAAE,eAAe,KAAK,IAAI,CAAC;AAEnE,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,OAAO,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,OAAO,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAiBD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAExD;AAoED,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,KAAK,GAAG,KAAK,CAAC,CAYnE;AAMD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAC3B,UAAU,EAAE,MAAM,EAClB,UAAU,CAAC,EAAE,gBAAgB,EAC7B,gBAAgB,CAAC,EAAE,MAAM,GACxB,OAAO,CAAC,aAAa,CAAC,CAIxB;AAmKD;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,UAAU,EAAE,MAAM,EAClB,UAAU,CAAC,EAAE,gBAAgB,EAC7B,gBAAgB,CAAC,EAAE,MAAM,GACxB,OAAO,CAAC,aAAa,CAAC,CAcxB;AAMD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAE5E;AA6DD;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,eAAe,CAAC,CAQ1B;AAgKD,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,kBAAkB,GACvB,OAAO,CAAC,MAAM,CAAC,CA2BjB;AAsLD,uDAAuD;AACvD,wBAAgB,oBAAoB,IAAI,KAAK,CAAC;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC,CAUD"}
+{"version":3,"file":"plugin-installer.d.ts","sourceRoot":"","sources":["../../src/services/plugin-installer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAWH,OAAO,EAAiB,KAAK,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAU9E,uEAAuE;AACvE,eAAO,MAAM,kBAAkB,QACiB,CAAC;AAKjD,uFAAuF;AACvF,eAAO,MAAM,YAAY,QAA0B,CAAC;AAEpD,wDAAwD;AACxD,eAAO,MAAM,aAAa,QAAyC,CAAC;AAKpE,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAIzD;AAQD,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAInD;AAYD,MAAM,MAAM,YAAY,GACpB,WAAW,GACX,aAAa,GACb,iBAAiB,GACjB,YAAY,GACZ,aAAa,GACb,YAAY,GACZ,UAAU,GACV,OAAO,CAAC;AAEZ,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,YAAY,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,gBAAgB,GAAG,CAAC,QAAQ,EAAE,eAAe,KAAK,IAAI,CAAC;AAEnE,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,OAAO,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,OAAO,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAiBD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAExD;AAoED,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,KAAK,GAAG,KAAK,CAAC,CAenE;AAMD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAC3B,UAAU,EAAE,MAAM,EAClB,UAAU,CAAC,EAAE,gBAAgB,EAC7B,gBAAgB,CAAC,EAAE,MAAM,GACxB,OAAO,CAAC,aAAa,CAAC,CAIxB;AAmKD;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,UAAU,EAAE,MAAM,EAClB,UAAU,CAAC,EAAE,gBAAgB,EAC7B,gBAAgB,CAAC,EAAE,MAAM,GACxB,OAAO,CAAC,aAAa,CAAC,CAcxB;AAMD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAE5E;AA6DD;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,eAAe,CAAC,CAQ1B;AAgKD,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,kBAAkB,GACvB,OAAO,CAAC,MAAM,CAAC,CA2BjB;AAgMD,uDAAuD;AACvD,wBAAgB,oBAAoB,IAAI,KAAK,CAAC;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC,CAUD"}

package/services/plugin-installer.js

@@ -130,7 +130,10 @@ function resolveInstallVersion(canonicalName, info, requestedVersion) {
 export async function detectPackageManager() {
     for (const cmd of ["bun", "npm"]) {
         try {
-            await execFileAsync(cmd, ["--version"]);
+            await execFileAsync(cmd, ["--version"], {
+                // npm is a `.cmd` shim on Windows; Node can't spawn it without a shell.
+                shell: process.platform === "win32",
+            });
             return cmd;
         }
         catch (err) {
@@ -409,13 +412,10 @@ async function runInstallSpec(pm, spec, targetDir) {
             });
             break;
         default:
-            await execFileAsync("npm", [
-                "install",
-                "--ignore-scripts",
-                spec,
-                "--prefix",
-                targetDir,
-            ]);
+            await execFileAsync("npm", ["install", "--ignore-scripts", spec, "--prefix", targetDir], 
+            // npm is a `.cmd` shim on Windows; Node can't spawn it without a shell.
+            // `spec` is validated by assertValidPackageName/assertValidVersion.
+            { shell: process.platform === "win32" });
     }
 }
 async function readInstalledVersion(targetDir, packageName, fallbackVersion) {
@@ -537,11 +537,18 @@ async function gitCloneInstall(info, targetDir, onProgress) {
             message: "Installing dependencies...",
         });
         const pm = await detectPackageManager();
-        await execFileAsync(pm, ["install", "--ignore-scripts"], { cwd: tempDir });
+        await execFileAsync(pm, ["install", "--ignore-scripts"], {
+            cwd: tempDir,
+            // `pm` is npm.cmd on Windows when bun is absent; needs a shell to resolve.
+            shell: process.platform === "win32",
+        });
         const registrySourceDir = resolveRegistrySourceDir(tempDir, info.directory);
         if (registrySourceDir !== tempDir) {
             try {
-                await execFileAsync(pm, ["run", "build"], { cwd: registrySourceDir });
+                await execFileAsync(pm, ["run", "build"], {
+                    cwd: registrySourceDir,
+                    shell: process.platform === "win32",
+                });
             }
             catch (buildErr) {
                 logger.warn(`[plugin-installer] build step failed for ${info.name}: ${buildErr instanceof Error ? buildErr.message : String(buildErr)}`);
@@ -565,7 +572,10 @@ async function gitCloneInstall(info, targetDir, onProgress) {
         }
         let buildFailed = false;
         try {
-            await execFileAsync(pm, ["run", "build"], { cwd: tsDir });
+            await execFileAsync(pm, ["run", "build"], {
+                cwd: tsDir,
+                shell: process.platform === "win32",
+            });
         }
         catch (buildErr) {
             buildFailed = true;

package/services/plugin-manager-types.d.ts

@@ -1,4 +1,4 @@
-import type { AppUiExtensionConfig, RegistryAppMeta, RegistryAppSessionFeature, RegistryAppSessionMeta, RegistryAppSessionMode, RegistryAppViewerMeta, RegistryPluginInfo as RegistryClientPluginInfo, RegistrySearchResult as RegistryClientSearchResult } from "./registry-client-types.ts";
+import type { AppUiExtensionConfig, RegistryAppMeta, RegistryAppSessionFeature, RegistryAppSessionMeta, RegistryAppSessionMode, RegistryAppViewerMeta, RegistryPluginInfo as RegistryClientPluginInfo, RegistrySearchResult as RegistryClientSearchResult } from "./registry-client-types.js";
 export type { AppUiExtensionConfig };
 export type RegistryVersionSupport = RegistryClientPluginInfo["supports"];
 export type RegistryPluginNpmInfo = RegistryClientPluginInfo["npm"];

package/services/proactive-interaction-decider.d.ts

@@ -1,10 +1,10 @@
 /**
  * Proactive-interaction decider (#8792).
  *
- * Consumes UI interaction events (view switches today; slash/shortcut wireable
- * the same way) and decides whether to surface a single scoped, helpful comment
- * through the existing `routeAutonomyTextToUser` → `proactive-message` pipeline
- * with `source: "proactive-interaction"`.
+ * Consumes UI interaction events (view switches, slash commands, shortcuts) and
+ * decides whether to surface a single scoped, helpful offer through either the
+ * existing `routeAutonomyTextToUser` → `proactive-message` pipeline with
+ * `source: "proactive-interaction"` or the low-priority notification rail.
  *
  * Two layers, both testable in isolation:
  *  - {@link decideProactiveComment} — the pure policy + governance decision
@@ -13,21 +13,66 @@
  *    subscribes to the event bus, runs the small-model judge, and routes the
  *    admitted comment.
  */
-import { type IAgentRuntime, type ViewSwitchedPayload } from "@elizaos/core";
-import { type ProactiveInteractionGate } from "./proactive-interaction-gate.ts";
+import { type IAgentRuntime, type ShortcutFiredPayload, type SlashCommandInvokedPayload, type ViewSwitchedPayload } from "@elizaos/core";
+import { type ProactiveInteractionGate } from "./proactive-interaction-gate.js";
 /** Source tag for proactive comments driven by UI interactions. */
 export declare const PROACTIVE_INTERACTION_SOURCE = "proactive-interaction";
-/** A model judge: given a view-switch context, return an offer or null. */
-export type ProactiveJudge = (payload: ViewSwitchedPayload) => Promise<string | null>;
+/** Any interaction the decider reacts to (#8792). */
+export type InteractionPayload = ViewSwitchedPayload | SlashCommandInvokedPayload | ShortcutFiredPayload;
+/**
+ * Runtime setting key for the user-facing "Proactive suggestions" control
+ * (off/subtle/chatty). Read via `runtime.getSetting`, it takes precedence over
+ * the `ELIZA_PROACTIVE_INTERACTIONS` env default inside the gate resolver.
+ */
+export declare const PROACTIVE_CHATTINESS_SETTING_KEY = "ELIZA_PROACTIVE_INTERACTIONS";
+/** Where an admitted proactive offer should be delivered. */
+export type ProactiveDelivery = "chat" | "notify";
+/** A scoped offer from the judge, normalized before governance/admission. */
+export interface ProactiveOffer {
+    text: string;
+    delivery: ProactiveDelivery;
+    title?: string;
+    deepLink?: string;
+    groupKey?: string;
+}
+/** A model judge: given an interaction context, return an offer or null. */
+export type ProactiveJudgeResult = string | ProactiveOffer | null;
+export type ProactiveJudge = (payload: InteractionPayload) => Promise<ProactiveJudgeResult>;
 export interface DecideProactiveInput {
-    payload: ViewSwitchedPayload;
+    payload: InteractionPayload;
     gate: ProactiveInteractionGate;
     judge: ProactiveJudge;
     now: number;
 }
+/**
+ * Control / dismiss / help shortcuts that must never trigger a proactive comment
+ * (#8792). These are gestures, not intent: commenting on them is noise, and —
+ * critically — the small-model judge runs BEFORE the governance gate, so letting
+ * them reach the judge would spend a TEXT_SMALL call per keystroke. Denying them
+ * here (a surface of `null`) skips the judge entirely. Navigation-bearing
+ * shortcuts ("open X") report `VIEW_SWITCHED` through the navigate route instead,
+ * so SHORTCUT_FIRED stays a small, high-signal channel for non-navigation
+ * capability-invokes (e.g. opening the command palette).
+ */
+export declare const NON_PROACTIVE_SHORTCUT_IDS: ReadonlySet<string>;
+/**
+ * The governance surface for an interaction, or `null` when policy says never
+ * comment. Explicitly-typed slash commands return `null`: the user already
+ * expressed intent and the command produced its own reply, so a proactive
+ * comment would be double-talk (#8792 open question). Control/dismiss shortcuts
+ * are denied (see {@link NON_PROACTIVE_SHORTCUT_IDS}). View switches key on the
+ * view; remaining (intent-bearing) shortcuts key on the shortcut id.
+ */
+export declare function interactionSurface(payload: InteractionPayload): string | null;
 export interface DecideProactiveResult {
     /** The comment to surface, or null when none should be sent. */
     text: string | null;
+    /** Delivery rail for the admitted text. Null when no text is admitted. */
+    delivery: ProactiveDelivery | null;
+    /** Optional notification headline when delivery is notify. */
+    title?: string;
+    deepLink?: string;
+    groupKey?: string;
     reason: string;
 }
 /**
@@ -41,13 +86,19 @@ export interface DecideProactiveResult {
  *    call and records the emission.
  */
 export declare function decideProactiveComment(input: DecideProactiveInput): Promise<DecideProactiveResult>;
-/** Build the small-model judge prompt for a view switch. */
-export declare function buildProactiveJudgePrompt(payload: ViewSwitchedPayload): string;
+/** Build the small-model judge prompt for an interaction. */
+export declare function buildProactiveJudgePrompt(payload: InteractionPayload): string;
+/** Parse the judge model output into a typed offer or null. */
+export declare function parseProactiveJudgeDecisionOutput(raw: unknown): ProactiveOffer | null;
 /** Parse the judge model output into an offer string or null. */
 export declare function parseProactiveJudgeOutput(raw: unknown): string | null;
 export interface ProactiveDeciderWiring {
     /** Route an admitted comment to the user (proactive-message pipeline). */
     route: (text: string) => Promise<void>;
+    /** Route an admitted low-urgency offer to the notification rail. */
+    notify?: (offer: ProactiveOffer) => Promise<void>;
+    /** Suppress comments while a foreground chat turn is already speaking/typing. */
+    shouldSuppress?: () => boolean;
     gate: ProactiveInteractionGate;
     /** Override the clock (tests). */
     now?: () => number;

package/services/proactive-interaction-decider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"proactive-interaction-decider.d.ts","sourceRoot":"","sources":["../../src/services/proactive-interaction-decider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAEL,KAAK,aAAa,EAGlB,KAAK,mBAAmB,EACzB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,KAAK,wBAAwB,EAE9B,MAAM,iCAAiC,CAAC;AAEzC,mEAAmE;AACnE,eAAO,MAAM,4BAA4B,0BAA0B,CAAC;AAEpE,2EAA2E;AAC3E,MAAM,MAAM,cAAc,GAAG,CAC3B,OAAO,EAAE,mBAAmB,KACzB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;AAE5B,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,mBAAmB,CAAC;IAC7B,IAAI,EAAE,wBAAwB,CAAC;IAC/B,KAAK,EAAE,cAAc,CAAC;IACtB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,qBAAqB;IACpC,gEAAgE;IAChE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;GASG;AACH,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,oBAAoB,GAC1B,OAAO,CAAC,qBAAqB,CAAC,CAuBhC;AASD,4DAA4D;AAC5D,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,mBAAmB,GAC3B,MAAM,CAGR;AAED,iEAAiE;AACjE,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAqBrE;AAED,MAAM,WAAW,sBAAsB;IACrC,0EAA0E;IAC1E,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,IAAI,EAAE,wBAAwB,CAAC;IAC/B,kCAAkC;IAClC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAED;;;;;GAKG;AACH,wBAAgB,mCAAmC,CACjD,OAAO,EAAE,aAAa,EACtB,MAAM,EAAE,sBAAsB,GAC7B,IAAI,CAoDN"}
+{"version":3,"file":"proactive-interaction-decider.d.ts","sourceRoot":"","sources":["../../src/services/proactive-interaction-decider.ts"],"names":[],"mappings":"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"}