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

package/services/media-generation.js

@@ -0,0 +1,102 @@
+import { IMediaGenerationService, ServiceType, } from "@elizaos/core";
+import { isElizaCloudServiceSelectedInConfig } from "@elizaos/shared";
+import { loadElizaConfig } from "../config/config.js";
+import { createAudioProvider, createImageProvider, createVideoProvider, } from "../providers/media-provider.js";
+function getMediaProviderOptions() {
+    const config = loadElizaConfig();
+    const cloudMediaSelected = isElizaCloudServiceSelectedInConfig(config, "media");
+    return {
+        elizaCloudBaseUrl: config.cloud?.baseUrl ?? "https://elizacloud.ai/api/v1",
+        elizaCloudApiKey: config.cloud?.apiKey,
+        cloudMediaDisabled: !cloudMediaSelected,
+    };
+}
+export class AgentMediaGenerationService extends IMediaGenerationService {
+    static serviceType = ServiceType.MEDIA_GENERATION;
+    capabilityDescription = "Generates image, video, and audio through configured local media providers.";
+    static async start(runtime) {
+        return new AgentMediaGenerationService(runtime);
+    }
+    async stop() { }
+    canGenerateMedia(request) {
+        const config = loadElizaConfig();
+        const providerOptions = getMediaProviderOptions();
+        try {
+            if (request.mediaType === "image") {
+                createImageProvider(config.media?.image, providerOptions);
+                return true;
+            }
+            if (request.mediaType === "video") {
+                createVideoProvider(config.media?.video, providerOptions);
+                return true;
+            }
+            createAudioProvider(config.media?.audio, providerOptions);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async generateMedia(request) {
+        const config = loadElizaConfig();
+        const providerOptions = getMediaProviderOptions();
+        if (request.mediaType === "image") {
+            const result = await createImageProvider(config.media?.image, providerOptions).generate({
+                prompt: request.prompt,
+                size: request.size,
+                quality: request.quality,
+                style: request.style,
+                negativePrompt: request.negativePrompt,
+                seed: request.seed,
+            });
+            if (!result.success || !result.data) {
+                throw new Error(result.error ?? "Image generation failed");
+            }
+            return {
+                mediaType: "image",
+                url: result.data.imageUrl,
+                imageUrl: result.data.imageUrl,
+                imageBase64: result.data.imageBase64,
+                revisedPrompt: result.data.revisedPrompt,
+                mimeType: "image/png",
+            };
+        }
+        if (request.mediaType === "video") {
+            const result = await createVideoProvider(config.media?.video, providerOptions).generate({
+                prompt: request.prompt,
+                duration: request.duration ?? config.media?.video?.defaultDuration,
+                aspectRatio: request.aspectRatio,
+                imageUrl: request.imageUrl,
+            });
+            if (!result.success || !result.data) {
+                throw new Error(result.error ?? "Video generation failed");
+            }
+            return {
+                mediaType: "video",
+                url: result.data.videoUrl,
+                videoUrl: result.data.videoUrl,
+                thumbnailUrl: result.data.thumbnailUrl,
+                duration: result.data.duration,
+                mimeType: "video/mp4",
+            };
+        }
+        const result = await createAudioProvider(config.media?.audio, providerOptions).generate({
+            prompt: request.prompt,
+            duration: request.duration,
+            instrumental: request.instrumental,
+            genre: request.genre,
+        });
+        if (!result.success || !result.data) {
+            throw new Error(result.error ?? "Audio generation failed");
+        }
+        return {
+            mediaType: "audio",
+            audioKind: request.audioKind,
+            url: result.data.audioUrl,
+            audioUrl: result.data.audioUrl,
+            title: result.data.title,
+            duration: result.data.duration,
+            mimeType: "audio/mpeg",
+        };
+    }
+}

package/services/overlay-app-presence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlay-app-presence.d.ts","sourceRoot":"","sources":["../../src/services/overlay-app-presence.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAO,MAAM,2BAA2B,QAAS,CAAC;AAKlD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAGlE;AAED,wBAAgB,0BAA0B,CACxC,gBAAgB,EAAE,MAAM,EACxB,QAAQ,GAAE,MAAoC,GAC7C,OAAO,CAKT"}

package/services/owner-name.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"owner-name.d.ts","sourceRoot":"","sources":["../../src/services/owner-name.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,qBAAqB,KAAK,CAAC;AAiBxC,wBAAsB,wBAAwB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAQvE;AAED,wBAAsB,0BAA0B,CAC9C,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,OAAO,CAAC,CAoBlB"}

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

@@ -0,0 +1,8 @@
+/**
+ * Runtime pending-prompts store: open scheduled-task prompts awaiting an
+ * owner reply, surfaced through the registered {@link PendingPromptsService}.
+ * Cache-backed (no SQL), keyed per room.
+ */
+export { PENDING_PROMPTS_SERVICE, PendingPromptsService, resolvePendingPromptsService, } from "./service.js";
+export { createPendingPromptsStore, type ExpectedReplyKind, type PendingPrompt, type PendingPromptRecordInput, type PendingPromptsStore, type PendingPromptWithRoom, type RecordedPendingPrompt, } from "./store.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/services/pending-prompts/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,uBAAuB,EACvB,qBAAqB,EACrB,4BAA4B,GAC7B,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,yBAAyB,EACzB,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAClB,KAAK,wBAAwB,EAC7B,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,GAC3B,MAAM,YAAY,CAAC"}

package/services/pending-prompts/index.js

@@ -0,0 +1,7 @@
+/**
+ * Runtime pending-prompts store: open scheduled-task prompts awaiting an
+ * owner reply, surfaced through the registered {@link PendingPromptsService}.
+ * Cache-backed (no SQL), keyed per room.
+ */
+export { PENDING_PROMPTS_SERVICE, PendingPromptsService, resolvePendingPromptsService, } from "./service.js";
+export { createPendingPromptsStore, } from "./store.js";

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

@@ -0,0 +1,34 @@
+/**
+ * PendingPromptsService — the runtime-owned store of open scheduled-task
+ * prompts, exposed as a registered runtime service.
+ *
+ * Pending prompts are a runtime primitive: any plugin (LifeOps scheduler, the
+ * work-thread evaluator, …) consumes the store via `runtime.getService(...)`
+ * rather than constructing the cache-backed store itself. The service is a thin
+ * factory over the per-runtime {@link PendingPromptsStore}; the store is
+ * cache-backed (no SQL), keyed per room.
+ *
+ * Mirrors `KnowledgeGraphService` (lifecycle + getService accessor).
+ */
+import { type IAgentRuntime, type PendingUserAction, Service } from "@elizaos/core";
+import { type PendingPromptsStore } from "./store.js";
+export declare const PENDING_PROMPTS_SERVICE = "eliza_pending_prompts";
+export declare class PendingPromptsService extends Service {
+    static serviceType: string;
+    capabilityDescription: string;
+    static start(runtime: IAgentRuntime): Promise<PendingPromptsService>;
+    stop(): Promise<void>;
+    /** The cache-backed pending-prompts store for this runtime. */
+    getStore(): PendingPromptsStore;
+    /**
+     * Canonical "agent is waiting on you" projection for all open prompts.
+     * UI/provider surfaces should consume this instead of reshaping store records.
+     */
+    listPendingUserActions(): Promise<PendingUserAction[]>;
+}
+/**
+ * Resolve the registered {@link PendingPromptsService}. Returns `null` when the
+ * runtime has not registered it (e.g. the "eliza" plugin is absent).
+ */
+export declare function resolvePendingPromptsService(runtime: IAgentRuntime): PendingPromptsService | null;
+//# sourceMappingURL=service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../src/services/pending-prompts/service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,OAAO,EACR,MAAM,eAAe,CAAC;AACvB,OAAO,EAGL,KAAK,mBAAmB,EACzB,MAAM,YAAY,CAAC;AAEpB,eAAO,MAAM,uBAAuB,0BAA0B,CAAC;AAE/D,qBAAa,qBAAsB,SAAQ,OAAO;IAChD,OAAgB,WAAW,SAA2B;IAE7C,qBAAqB,SACwD;WAEzE,KAAK,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAIpE,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAE3B,+DAA+D;IAC/D,QAAQ,IAAI,mBAAmB;IAI/B;;;OAGG;IACG,sBAAsB,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC;CAwB7D;AAQD;;;GAGG;AACH,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,aAAa,GACrB,qBAAqB,GAAG,IAAI,CAE9B"}

package/services/pending-prompts/service.js

@@ -0,0 +1,68 @@
+/**
+ * PendingPromptsService — the runtime-owned store of open scheduled-task
+ * prompts, exposed as a registered runtime service.
+ *
+ * Pending prompts are a runtime primitive: any plugin (LifeOps scheduler, the
+ * work-thread evaluator, …) consumes the store via `runtime.getService(...)`
+ * rather than constructing the cache-backed store itself. The service is a thin
+ * factory over the per-runtime {@link PendingPromptsStore}; the store is
+ * cache-backed (no SQL), keyed per room.
+ *
+ * Mirrors `KnowledgeGraphService` (lifecycle + getService accessor).
+ */
+import { Service, } from "@elizaos/core";
+import { createPendingPromptsStore, } from "./store.js";
+export const PENDING_PROMPTS_SERVICE = "eliza_pending_prompts";
+export class PendingPromptsService extends Service {
+    static serviceType = PENDING_PROMPTS_SERVICE;
+    capabilityDescription = "Runtime pending-prompts store: open scheduled-task prompts per room, cache-backed";
+    static async start(runtime) {
+        return new PendingPromptsService(runtime);
+    }
+    async stop() { }
+    /** The cache-backed pending-prompts store for this runtime. */
+    getStore() {
+        return createPendingPromptsStore(this.runtime);
+    }
+    /**
+     * Canonical "agent is waiting on you" projection for all open prompts.
+     * UI/provider surfaces should consume this instead of reshaping store records.
+     */
+    async listPendingUserActions() {
+        const prompts = await this.getStore().listAll();
+        return prompts.map((prompt) => ({
+            id: prompt.taskId,
+            kind: "pending_prompt",
+            source: "pending-prompts",
+            title: prompt.promptSnippet,
+            roomId: prompt.roomId,
+            expectedReplyKind: prompt.expectedReplyKind,
+            weight: promptWeight(prompt.expectedReplyKind),
+            resolution: {
+                target: "pending_prompt",
+                requestId: prompt.taskId,
+            },
+            data: {
+                expectedReplyKind: prompt.expectedReplyKind,
+            },
+            createdAt: Date.parse(prompt.firedAt),
+            expiresAt: prompt.expiresAt && Number.isFinite(Date.parse(prompt.expiresAt))
+                ? Date.parse(prompt.expiresAt)
+                : null,
+        }));
+    }
+}
+function promptWeight(kind) {
+    if (kind === "approval")
+        return 9;
+    if (kind === "yes_no")
+        return 7;
+    return 6;
+}
+/**
+ * Resolve the registered {@link PendingPromptsService}. Returns `null` when the
+ * runtime has not registered it (e.g. the "eliza" plugin is absent).
+ */
+export function resolvePendingPromptsService(runtime) {
+    return runtime.getService(PENDING_PROMPTS_SERVICE);
+}

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/permissions/contracts.d.ts

@@ -0,0 +1,2 @@
+export type { IPermissionsRegistry, PermissionId, PermissionRestrictedReason, PermissionState, PermissionStatus, Platform as PermissionPlatform, Prober, } from "@elizaos/shared";
+//# sourceMappingURL=contracts.d.ts.map

package/services/permissions/contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.d.ts","sourceRoot":"","sources":["../../../src/services/permissions/contracts.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,oBAAoB,EACpB,YAAY,EACZ,0BAA0B,EAC1B,eAAe,EACf,gBAAgB,EAChB,QAAQ,IAAI,kBAAkB,EAC9B,MAAM,GACP,MAAM,iBAAiB,CAAC"}

package/services/permissions/contracts.js

@@ -0,0 +1 @@
+export {};

package/services/permissions/probers/_bridge.d.ts

@@ -0,0 +1,112 @@
+/**
+ * Shared bridge helpers for native permission probers.
+ *
+ * Consolidates:
+ *   - platform detection
+ *   - osascript shellouts (used for AppleScript permission checks)
+ *   - bundle identifier resolution and TCC.db reads
+ *   - bun:ffi loader for the existing macOS permissions dylib
+ *     (`libMacWindowEffects.dylib`, built under
+ *     `packages/app-core/platforms/electrobun/src/`)
+ *
+ * The TCC.db read trick lets us answer `check()` without triggering an OS
+ * dialog: TCC's authorization database is readable via sqlite3 for the
+ * current user. This is the canonical "preflight" technique used elsewhere
+ * in the codebase (see `permissions-darwin.ts`).
+ */
+import type { PermissionId, PermissionPlatform, PermissionState, PermissionStatus } from "../contracts.js";
+export declare const PLATFORM: PermissionPlatform;
+export declare const IS_DARWIN: boolean;
+/**
+ * Build a `PermissionState` with sane defaults (`lastChecked = now`,
+ * platform pre-filled). Caller fills the parts that vary.
+ */
+export declare function buildState(id: PermissionId, status: PermissionStatus, options?: Partial<Omit<PermissionState, "id" | "status" | "lastChecked" | "platform">>): PermissionState;
+/**
+ * Short-circuit state for non-darwin platforms where the permission is a
+ * macOS-only concept (Reminders, Calendar, Notes, ScreenTime, Health,
+ * Accessibility, Screen Recording, Full Disk, Automation).
+ */
+export declare function platformUnsupportedState(id: PermissionId): PermissionState;
+/**
+ * Run an osascript snippet and return stdout. Returns `null` on non-zero
+ * exit (which happens when the user denies an Automation prompt or the
+ * scripted target isn't available).
+ *
+ * IMPORTANT: this can trigger a TCC Automation prompt if `script` targets
+ * an app the runtime hasn't been authorized for yet. Use TCC.db reads in
+ * `check()` paths and reserve osascript for `request()` paths.
+ */
+export declare function runOsascript(script: string, timeoutMs?: number): Promise<string | null>;
+/**
+ * Read TCC.db for a specific service+client. Returns:
+ *   - "granted"  if auth_value=2
+ *   - "denied"   if auth_value=0
+ *   - null       on error or row missing (caller should treat as not-determined)
+ *
+ * Note: macOS 11+ moves some entries to the system TCC.db
+ * (`/Library/Application Support/com.apple.TCC/TCC.db`) which requires Full
+ * Disk Access to read. We only consult the per-user TCC.db here.
+ */
+export declare function queryTccStatus(service: string, bundleIdentifier: string): Promise<"granted" | "denied" | null>;
+/**
+ * Read TCC.db for Apple Events permission from this runtime to a target app.
+ *
+ * Remaining AppleScript-driven integrations such as Calendar.app, Notes.app,
+ * and System Events are not represented by the target app's domain TCC
+ * service. They live under kTCCServiceAppleEvents keyed by both sender bundle
+ * id (`client`) and target bundle id (`indirect_object_identifier`). This
+ * check is read-only and must be used instead of probing with osascript in
+ * `check()` paths.
+ */
+export declare function queryAppleEventsTccStatus(targetBundleIdentifier: string, bundleIdentifier?: string): Promise<"granted" | "denied" | null>;
+/**
+ * Resolve the runtime bundle identifier from the running app's Info.plist.
+ * Falls back to a sensible default for dev (unsigned bun runtime).
+ */
+export declare function resolveBundleId(execPath?: string): string;
+/**
+ * Best-effort entitlement check against the running app's embedded
+ * provisioning profile. Unsigned dev builds do not have this file.
+ */
+export declare function hasEmbeddedProvisioningEntitlement(entitlement: string, execPath?: string): boolean;
+interface NativePermissionsLib {
+    requestAccessibilityPermission: () => boolean;
+    checkAccessibilityPermission: () => boolean;
+    requestScreenRecordingPermission: () => boolean;
+    checkScreenRecordingPermission: () => boolean;
+    checkRemindersPermission: () => number;
+    requestRemindersPermission: () => number;
+    checkCalendarPermission: () => number;
+    requestCalendarPermission: () => number;
+    checkContactsPermission: () => number;
+    requestContactsPermission: () => number;
+    checkLocationPermission: () => number;
+    requestLocationPermission: () => number;
+    checkMicrophonePermission: () => number;
+    checkCameraPermission: () => number;
+    checkNotificationPermission: () => number;
+    requestNotificationPermission: () => number;
+    requestCameraPermission: () => void;
+    requestMicrophonePermission: () => void;
+}
+export declare function getNativeDylib(): Promise<NativePermissionsLib | null>;
+/** Map AVCaptureDevice authorizationStatus values to PermissionStatus. */
+export declare function mapAVAuthStatus(value: number): PermissionStatus;
+/** Map native UNUserNotificationCenter status values to PermissionStatus. */
+export declare function mapUNAuthStatus(value: number): PermissionStatus;
+/**
+ * Map native privacy authorization status values from EventKit and Contacts.
+ * 0=not determined, 1=denied, 2=granted, 3=restricted, 4=write-only.
+ * Write-only is intentionally restricted for our canonical permissions
+ * because our features need read/update/delete semantics after creation.
+ */
+export declare function mapNativePrivacyAuthStatus(value: number): PermissionStatus;
+/**
+ * Open System Settings to a privacy pane. Best-effort; returns nothing.
+ * Used by `request()` paths after the OS has refused (or there's no API to
+ * trigger the prompt programmatically).
+ */
+export declare function openPrivacyPane(pane: string): Promise<void>;
+export {};
+//# sourceMappingURL=_bridge.d.ts.map

package/services/permissions/probers/_bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_bridge.d.ts","sourceRoot":"","sources":["../../../../src/services/permissions/probers/_bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AASH,OAAO,KAAK,EACV,YAAY,EACZ,kBAAkB,EAClB,eAAe,EACf,gBAAgB,EACjB,MAAM,iBAAiB,CAAC;AAEzB,eAAO,MAAM,QAAQ,EAAE,kBACiB,CAAC;AAEzC,eAAO,MAAM,SAAS,SAAwB,CAAC;AAI/C;;;GAGG;AACH,wBAAgB,UAAU,CACxB,EAAE,EAAE,YAAY,EAChB,MAAM,EAAE,gBAAgB,EACxB,OAAO,GAAE,OAAO,CACd,IAAI,CAAC,eAAe,EAAE,IAAI,GAAG,QAAQ,GAAG,aAAa,GAAG,UAAU,CAAC,CAC/D,GACL,eAAe,CAkBjB;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,EAAE,EAAE,YAAY,GAAG,eAAe,CAK1E;AAED;;;;;;;;GAQG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,MAAM,EACd,SAAS,SAAO,GACf,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAWxB;AAED;;;;;;;;;GASG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,MAAM,EACf,gBAAgB,EAAE,MAAM,GACvB,OAAO,CAAC,SAAS,GAAG,QAAQ,GAAG,IAAI,CAAC,CA2BtC;AAMD;;;;;;;;;GASG;AACH,wBAAsB,yBAAyB,CAC7C,sBAAsB,EAAE,MAAM,EAC9B,gBAAgB,SAAoB,GACnC,OAAO,CAAC,SAAS,GAAG,QAAQ,GAAG,IAAI,CAAC,CAiCtC;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,QAAQ,SAAmB,GAAG,MAAM,CAcnE;AAOD;;;GAGG;AACH,wBAAgB,kCAAkC,CAChD,WAAW,EAAE,MAAM,EACnB,QAAQ,SAAmB,GAC1B,OAAO,CAWT;AAoBD,UAAU,oBAAoB;IAC5B,8BAA8B,EAAE,MAAM,OAAO,CAAC;IAC9C,4BAA4B,EAAE,MAAM,OAAO,CAAC;IAC5C,gCAAgC,EAAE,MAAM,OAAO,CAAC;IAChD,8BAA8B,EAAE,MAAM,OAAO,CAAC;IAC9C,wBAAwB,EAAE,MAAM,MAAM,CAAC;IACvC,0BAA0B,EAAE,MAAM,MAAM,CAAC;IACzC,uBAAuB,EAAE,MAAM,MAAM,CAAC;IACtC,yBAAyB,EAAE,MAAM,MAAM,CAAC;IACxC,uBAAuB,EAAE,MAAM,MAAM,CAAC;IACtC,yBAAyB,EAAE,MAAM,MAAM,CAAC;IACxC,uBAAuB,EAAE,MAAM,MAAM,CAAC;IACtC,yBAAyB,EAAE,MAAM,MAAM,CAAC;IACxC,yBAAyB,EAAE,MAAM,MAAM,CAAC;IACxC,qBAAqB,EAAE,MAAM,MAAM,CAAC;IACpC,2BAA2B,EAAE,MAAM,MAAM,CAAC;IAC1C,6BAA6B,EAAE,MAAM,MAAM,CAAC;IAC5C,uBAAuB,EAAE,MAAM,IAAI,CAAC;IACpC,2BAA2B,EAAE,MAAM,IAAI,CAAC;CACzC;AAgBD,wBAAsB,cAAc,IAAI,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CA8C3E;AAED,0EAA0E;AAC1E,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,gBAAgB,CAK/D;AAED,6EAA6E;AAC7E,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,gBAAgB,CAK/D;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,MAAM,GAAG,gBAAgB,CAK1E;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAQjE"}