@elizaos/agent 0.25.9 → 2.0.0-alpha.144

package/packages/agent/src/activity-profile/service.js

@@ -0,0 +1,226 @@
+import { logger } from "@elizaos/core";
+import { resolveDefaultTimeZone } from "../lifeops/defaults.js";
+import { LifeOpsScreenContextSampler, } from "../lifeops/screen-context.js";
+import { LifeOpsService } from "../lifeops/service.js";
+export { resolveOwnerEntityId } from "../runtime/owner-entity.js";
+import { analyzeMessages, enrichWithCalendar, resolveCurrentActivityState, SUSTAINED_INACTIVITY_GAP_MS, } from "./analyzer.js";
+function isRecord(value) {
+    return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
+// ── Constants ─────────────────────────────────────────
+const PROFILE_MAX_AGE_MS = 60 * 60 * 1000; // 60 min full rebuild threshold
+const MESSAGES_WINDOW_DAYS = 7;
+const MESSAGES_LIMIT = 500;
+const MAX_ROOMS = 50;
+const ACTIVITY_SIGNALS_WINDOW_LIMIT = 500;
+const CURRENT_ACTIVITY_SIGNAL_LIMIT = 32;
+let screenContextSampler = null;
+export function setScreenContextSamplerForTesting(sampler) {
+    screenContextSampler = sampler;
+}
+function getScreenContextSampler() {
+    if (!screenContextSampler) {
+        screenContextSampler = new LifeOpsScreenContextSampler();
+    }
+    return screenContextSampler;
+}
+async function sampleScreenContext(currentTime) {
+    return await getScreenContextSampler().sample(currentTime.getTime());
+}
+function mapActivitySignalRecord(signal) {
+    return {
+        source: signal.source,
+        platform: signal.platform,
+        state: signal.state,
+        observedAt: Date.parse(signal.observedAt),
+        idleState: signal.idleState,
+        idleTimeSeconds: signal.idleTimeSeconds,
+        onBattery: signal.onBattery,
+        health: signal.health,
+        metadata: signal.metadata,
+    };
+}
+async function loadWindowActivitySignals(runtime, currentTime) {
+    const lifeOpsService = new LifeOpsService(runtime);
+    const sinceAt = new Date(currentTime.getTime() - MESSAGES_WINDOW_DAYS * 24 * 60 * 60 * 1000).toISOString();
+    const signals = await lifeOpsService.listActivitySignals({
+        sinceAt,
+        limit: ACTIVITY_SIGNALS_WINDOW_LIMIT,
+    });
+    return signals
+        .map(mapActivitySignalRecord)
+        .filter((signal) => Number.isFinite(signal.observedAt));
+}
+async function loadRecentActivitySignals(runtime) {
+    const lifeOpsService = new LifeOpsService(runtime);
+    const signals = await lifeOpsService.listActivitySignals({
+        limit: CURRENT_ACTIVITY_SIGNAL_LIMIT,
+    });
+    return signals
+        .map(mapActivitySignalRecord)
+        .filter((signal) => Number.isFinite(signal.observedAt));
+}
+function mergeScreenContext(profile, screenContext, now) {
+    const updatedProfile = {
+        ...profile,
+        screenContextFocus: screenContext?.focus ?? null,
+        screenContextSource: screenContext?.source ?? null,
+        screenContextSampledAt: screenContext?.sampledAtMs ?? null,
+        screenContextConfidence: screenContext?.confidence ?? null,
+        screenContextBusy: screenContext?.busy ?? false,
+        screenContextAvailable: screenContext?.available ?? false,
+        screenContextStale: screenContext?.stale ?? false,
+    };
+    const activityState = resolveCurrentActivityState(updatedProfile, now);
+    return {
+        ...updatedProfile,
+        ...activityState,
+        effectiveDayKey: activityState.effectiveDayKey,
+    };
+}
+// ── Profile building ──────────────────────────────────
+export async function buildActivityProfile(runtime, ownerEntityId, timezone, now) {
+    const tz = timezone ?? resolveDefaultTimeZone();
+    const currentTime = now ?? new Date();
+    const activitySignals = await loadWindowActivitySignals(runtime, currentTime);
+    // 1. Get all rooms the owner participates in
+    const roomIds = await runtime.getRoomsForParticipant(ownerEntityId);
+    const limitedRoomIds = roomIds.slice(0, MAX_ROOMS);
+    // 2. Build room → source map
+    const roomSourceMap = new Map();
+    await Promise.all(limitedRoomIds.map(async (roomId) => {
+        try {
+            const room = await runtime.getRoom(roomId);
+            if (room?.source) {
+                roomSourceMap.set(roomId, room.source);
+            }
+        }
+        catch {
+            // Skip rooms we can't read
+        }
+    }));
+    // 3. Fetch messages
+    const messages = [];
+    if (limitedRoomIds.length > 0) {
+        const memories = await runtime.getMemoriesByRoomIds({
+            tableName: "messages",
+            roomIds: limitedRoomIds,
+            limit: MESSAGES_LIMIT,
+        });
+        for (const mem of memories) {
+            messages.push({
+                entityId: mem.entityId,
+                roomId: mem.roomId,
+                createdAt: mem.createdAt ?? 0,
+            });
+        }
+    }
+    // 4. Analyze messages
+    const baseProfile = analyzeMessages(messages, roomSourceMap, ownerEntityId, tz, MESSAGES_WINDOW_DAYS, activitySignals, currentTime);
+    // 5. Enrich with calendar if available
+    let calendarEvents = [];
+    try {
+        const lifeOpsService = new LifeOpsService(runtime);
+        const feed = await lifeOpsService.getCalendarFeed(new URL("http://localhost/api/lifeops/calendar"), {}, currentTime);
+        calendarEvents = feed.events.map((e) => ({
+            startAt: e.startAt,
+            endAt: e.endAt,
+            isAllDay: e.isAllDay,
+        }));
+    }
+    catch (err) {
+        logger.debug({
+            boundary: "activity_profile",
+            operation: "calendar_enrichment",
+            err: err instanceof Error ? err : undefined,
+        }, "[activity-profile] Calendar not available for profile enrichment; proceeding without calendar data.");
+    }
+    const withCalendar = enrichWithCalendar(baseProfile, calendarEvents, tz);
+    const screenContext = await sampleScreenContext(currentTime);
+    return mergeScreenContext(withCalendar, screenContext, currentTime);
+}
+// ── Lightweight current-state refresh ─────────────────
+export async function refreshCurrentState(runtime, ownerEntityId, profile, now) {
+    const currentTime = now ?? new Date();
+    const roomIds = await runtime.getRoomsForParticipant(ownerEntityId);
+    const limitedRoomIds = roomIds.slice(0, MAX_ROOMS);
+    const screenContext = await sampleScreenContext(currentTime);
+    const activitySignals = await loadRecentActivitySignals(runtime);
+    const roomSourceMap = new Map();
+    if (limitedRoomIds.length > 0) {
+        await Promise.all(limitedRoomIds.map(async (roomId) => {
+            try {
+                const room = await runtime.getRoom(roomId);
+                if (room?.source) {
+                    roomSourceMap.set(roomId, room.source);
+                }
+            }
+            catch {
+                // Skip rooms we cannot inspect during refresh.
+            }
+        }));
+    }
+    let lastSeenAt = profile.lastSeenAt;
+    let lastSeenPlatform = profile.lastSeenPlatform;
+    if (limitedRoomIds.length > 0) {
+        const memories = await runtime.getMemoriesByRoomIds({
+            tableName: "messages",
+            roomIds: limitedRoomIds,
+            limit: 10,
+        });
+        for (const memory of memories) {
+            const createdAt = memory.createdAt ?? 0;
+            if (createdAt > currentTime.getTime()) {
+                continue;
+            }
+            const source = roomSourceMap.get(memory.roomId) ?? "unknown";
+            const isOwnerMessage = memory.entityId === ownerEntityId;
+            const isClientChatSignal = source === "client_chat";
+            if (!isOwnerMessage && !isClientChatSignal) {
+                continue;
+            }
+            if (createdAt >= lastSeenAt) {
+                lastSeenAt = createdAt;
+                lastSeenPlatform = isClientChatSignal ? "client_chat" : source;
+            }
+        }
+    }
+    for (const signal of activitySignals) {
+        if (signal.state !== "active" ||
+            signal.observedAt > currentTime.getTime()) {
+            continue;
+        }
+        if (signal.observedAt >= lastSeenAt) {
+            lastSeenAt = signal.observedAt;
+            lastSeenPlatform = signal.platform;
+        }
+    }
+    return mergeScreenContext({
+        ...profile,
+        lastSeenAt,
+        lastSeenPlatform,
+        sustainedInactivityThresholdMinutes: profile.sustainedInactivityThresholdMinutes ||
+            SUSTAINED_INACTIVITY_GAP_MS / 60_000,
+    }, screenContext, currentTime);
+}
+// ── Metadata persistence helpers ──────────────────────
+// Re-export from dedicated module to preserve public API while breaking the
+// circular dependency between activity-profile/service and lifeops/service.
+export { readProfileFromMetadata } from "./profile-metadata.js";
+export function readFiredLogFromMetadata(metadata, todayDateStr) {
+    if (!metadata?.firedActionsLog)
+        return null;
+    const log = metadata.firedActionsLog;
+    if (!isRecord(log))
+        return null;
+    if (typeof log.date !== "string" || log.date !== todayDateStr)
+        return null;
+    if (!Array.isArray(log.nudgedOccurrenceIds))
+        return null;
+    return log;
+}
+export function profileNeedsRebuild(profile, now) {
+    if (!profile)
+        return true;
+    return now.getTime() - profile.analyzedAt > PROFILE_MAX_AGE_MS;
+}

package/packages/agent/src/activity-profile/types.d.ts

@@ -0,0 +1,89 @@
+import type { LifeOpsHealthSignal } from "@elizaos/shared/contracts/lifeops";
+export type TimeBucket = "EARLY_MORNING" | "MORNING" | "MIDDAY" | "AFTERNOON" | "EVENING" | "NIGHT" | "LATE_NIGHT";
+export declare const TIME_BUCKET_RANGES: Record<TimeBucket, {
+    start: number;
+    end: number;
+}>;
+export declare const ALL_TIME_BUCKETS: TimeBucket[];
+export declare function emptyBucketCounts(): Record<TimeBucket, number>;
+export interface PlatformActivity {
+    source: string;
+    messageCount: number;
+    bucketCounts: Record<TimeBucket, number>;
+    lastMessageAt: number;
+    averageMessagesPerDay: number;
+}
+export interface ActivitySignalRecord {
+    source: "app_lifecycle" | "page_visibility" | "desktop_power" | "mobile_device" | "mobile_health";
+    platform: string;
+    state: "active" | "idle" | "background" | "locked" | "sleeping";
+    observedAt: number;
+    idleState: "active" | "idle" | "locked" | "unknown" | null;
+    idleTimeSeconds: number | null;
+    onBattery: boolean | null;
+    health: LifeOpsHealthSignal | null;
+    metadata: Record<string, unknown>;
+}
+export interface ActivityProfile {
+    ownerEntityId: string;
+    analyzedAt: number;
+    analysisWindowDays: number;
+    timezone: string;
+    totalMessages: number;
+    sustainedInactivityThresholdMinutes: number;
+    platforms: PlatformActivity[];
+    primaryPlatform: string | null;
+    secondaryPlatform: string | null;
+    bucketCounts: Record<TimeBucket, number>;
+    hasCalendarData: boolean;
+    typicalFirstEventHour: number | null;
+    typicalLastEventHour: number | null;
+    avgWeekdayMeetings: number | null;
+    typicalFirstActiveHour: number | null;
+    typicalLastActiveHour: number | null;
+    typicalWakeHour: number | null;
+    typicalSleepHour: number | null;
+    hasSleepData: boolean;
+    isCurrentlySleeping: boolean;
+    lastSleepSignalAt: number | null;
+    lastWakeSignalAt: number | null;
+    sleepSourcePlatform: string | null;
+    sleepSource: string | null;
+    typicalSleepDurationMinutes: number | null;
+    lastSeenAt: number;
+    lastSeenPlatform: string | null;
+    isCurrentlyActive: boolean;
+    hasOpenActivityCycle: boolean;
+    currentActivityCycleStartedAt: number | null;
+    currentActivityCycleLocalDate: string | null;
+    effectiveDayKey: string;
+    screenContextFocus: "work" | "leisure" | "transition" | "idle" | "unknown" | null;
+    screenContextSource: "disabled" | "browser-capture" | "vision" | null;
+    screenContextSampledAt: number | null;
+    screenContextConfidence: number | null;
+    screenContextBusy: boolean;
+    screenContextAvailable: boolean;
+    screenContextStale: boolean;
+}
+export interface ProactiveAction {
+    kind: "gm" | "gn" | "pre_activity_nudge" | "goal_check_in" | "onboarding_seed";
+    scheduledFor: number;
+    targetPlatform: string;
+    contextSummary: string;
+    messageText: string;
+    occurrenceId?: string;
+    calendarEventId?: string;
+    goalId?: string;
+    status: "pending" | "fired" | "skipped";
+    skipReason?: string;
+}
+export interface FiredActionsLog {
+    date: string;
+    gmFiredAt?: number;
+    gnFiredAt?: number;
+    nudgedOccurrenceIds: string[];
+    nudgedCalendarEventIds: string[];
+    checkedGoalIds?: string[];
+    seedingOfferedAt?: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/packages/agent/src/activity-profile/types.d.ts.map

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

package/packages/agent/src/activity-profile/types.js

@@ -0,0 +1,29 @@
+export const TIME_BUCKET_RANGES = {
+    EARLY_MORNING: { start: 5, end: 7 },
+    MORNING: { start: 7, end: 10 },
+    MIDDAY: { start: 10, end: 14 },
+    AFTERNOON: { start: 14, end: 17 },
+    EVENING: { start: 17, end: 21 },
+    NIGHT: { start: 21, end: 25 }, // 25 = 1 AM next day
+    LATE_NIGHT: { start: 1, end: 5 },
+};
+export const ALL_TIME_BUCKETS = [
+    "EARLY_MORNING",
+    "MORNING",
+    "MIDDAY",
+    "AFTERNOON",
+    "EVENING",
+    "NIGHT",
+    "LATE_NIGHT",
+];
+export function emptyBucketCounts() {
+    return {
+        EARLY_MORNING: 0,
+        MORNING: 0,
+        MIDDAY: 0,
+        AFTERNOON: 0,
+        EVENING: 0,
+        NIGHT: 0,
+        LATE_NIGHT: 0,
+    };
+}

package/packages/agent/src/api/agent-admin-routes.d.ts

@@ -0,0 +1,39 @@
+import type { AgentRuntime, UUID } from "@elizaos/core";
+import type { RouteHelpers, RouteRequestMeta } from "./route-helpers.js";
+type AgentStateStatus = "not_started" | "starting" | "running" | "paused" | "stopped" | "restarting" | "error";
+import type { AutonomousConfigLike } from "../types/config-like.js";
+export interface AgentAdminRouteState {
+    runtime: AgentRuntime | null;
+    config: AutonomousConfigLike;
+    agentState: AgentStateStatus;
+    agentName: string;
+    model: string | undefined;
+    startedAt: number | undefined;
+    chatRoomId: UUID | null;
+    chatUserId: UUID | null;
+    chatConnectionReady: {
+        userId: UUID;
+        roomId: UUID;
+        worldId: UUID;
+    } | null;
+    chatConnectionPromise: Promise<void> | null;
+    pendingRestartReasons: string[];
+    conversations?: Map<string, unknown>;
+    activeConversationId?: string | null;
+    conversationRestorePromise?: Promise<void> | null;
+}
+export interface AgentAdminRouteContext extends RouteRequestMeta, Pick<RouteHelpers, "json" | "error"> {
+    state: AgentAdminRouteState;
+    onRestart?: (() => Promise<AgentRuntime | null>) | undefined;
+    onRuntimeSwapped?: () => void;
+    resolveStateDir: () => string;
+    resolvePath: (value: string) => string;
+    getHomeDir: () => string;
+    isSafeResetStateDir: (resolvedState: string, homeDir: string) => boolean;
+    stateDirExists: (resolvedState: string) => boolean;
+    removeStateDir: (resolvedState: string) => void;
+    logWarn: (message: string) => void;
+}
+export declare function handleAgentAdminRoutes(ctx: AgentAdminRouteContext): Promise<boolean>;
+export {};
+//# sourceMappingURL=agent-admin-routes.d.ts.map

package/packages/agent/src/api/agent-admin-routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-admin-routes.d.ts","sourceRoot":"","sources":["../../../../../src/api/agent-admin-routes.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AASxD,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEzE,KAAK,gBAAgB,GACjB,aAAa,GACb,UAAU,GACV,SAAS,GACT,QAAQ,GACR,SAAS,GACT,YAAY,GACZ,OAAO,CAAC;AAEZ,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAkBpE,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,YAAY,GAAG,IAAI,CAAC;IAC7B,MAAM,EAAE,oBAAoB,CAAC;IAC7B,UAAU,EAAE,gBAAgB,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,UAAU,EAAE,IAAI,GAAG,IAAI,CAAC;IACxB,UAAU,EAAE,IAAI,GAAG,IAAI,CAAC;IACxB,mBAAmB,EAAE;QAAE,MAAM,EAAE,IAAI,CAAC;QAAC,MAAM,EAAE,IAAI,CAAC;QAAC,OAAO,EAAE,IAAI,CAAA;KAAE,GAAG,IAAI,CAAC;IAC1E,qBAAqB,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC5C,qBAAqB,EAAE,MAAM,EAAE,CAAC;IAChC,aAAa,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,oBAAoB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,0BAA0B,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACnD;AAED,MAAM,WAAW,sBACf,SAAQ,gBAAgB,EACtB,IAAI,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC;IACtC,KAAK,EAAE,oBAAoB,CAAC;IAC5B,SAAS,CAAC,EAAE,CAAC,MAAM,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC,GAAG,SAAS,CAAC;IAC7D,gBAAgB,CAAC,EAAE,MAAM,IAAI,CAAC;IAC9B,eAAe,EAAE,MAAM,MAAM,CAAC;IAC9B,WAAW,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IACvC,UAAU,EAAE,MAAM,MAAM,CAAC;IACzB,mBAAmB,EAAE,CAAC,aAAa,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC;IACzE,cAAc,EAAE,CAAC,aAAa,EAAE,MAAM,KAAK,OAAO,CAAC;IACnD,cAAc,EAAE,CAAC,aAAa,EAAE,MAAM,KAAK,IAAI,CAAC;IAChD,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACpC;AAoBD,wBAAsB,sBAAsB,CAC1C,GAAG,EAAE,sBAAsB,GAC1B,OAAO,CAAC,OAAO,CAAC,CAwKlB"}

package/packages/agent/src/api/agent-admin-routes.js

@@ -0,0 +1,155 @@
+import path from "node:path";
+import { loadElizaConfig, saveElizaConfig } from "../config/config.js";
+import { resolveUserPath } from "../config/paths.js";
+import { getDefaultStylePreset, normalizeCharacterLanguage, } from "../onboarding-presets.js";
+import { clearPersistedOnboardingConfig } from "./provider-switch-config.js";
+import { detectRuntimeModel } from "./agent-model.js";
+function resolveDefaultAgentName(config) {
+    const ui = config.ui;
+    const agents = config.agents;
+    const configuredName = ui?.assistant?.name?.trim() ?? agents?.list?.[0]?.name?.trim();
+    if (configuredName) {
+        return configuredName;
+    }
+    return getDefaultStylePreset(normalizeCharacterLanguage(ui?.language)).name;
+}
+function resolveResetPgliteDataDir(config, stateDir) {
+    const explicitDataDir = process.env.PGLITE_DATA_DIR?.trim();
+    if (explicitDataDir) {
+        return resolveUserPath(explicitDataDir);
+    }
+    const configuredDataDir = config.database?.pglite?.dataDir?.trim();
+    if (configuredDataDir) {
+        return resolveUserPath(configuredDataDir);
+    }
+    const workspaceDir = config.agents?.defaults?.workspace ?? `${stateDir}/workspace`;
+    return path.join(resolveUserPath(workspaceDir), ".eliza", ".elizadb");
+}
+export async function handleAgentAdminRoutes(ctx) {
+    const { res, method, pathname, state, onRestart, onRuntimeSwapped, json, error, resolveStateDir, resolvePath, getHomeDir, isSafeResetStateDir, stateDirExists, removeStateDir, logWarn, } = ctx;
+    if (method === "POST" && pathname === "/api/agent/restart") {
+        if (!onRestart) {
+            error(res, "Restart is not supported in this mode (no restart handler registered)", 501);
+            return true;
+        }
+        if (state.agentState === "restarting") {
+            error(res, "A restart is already in progress", 409);
+            return true;
+        }
+        const previousState = state.agentState;
+        state.agentState = "restarting";
+        try {
+            const newRuntime = await onRestart();
+            if (newRuntime) {
+                state.runtime = newRuntime;
+                state.chatConnectionReady = null;
+                state.chatConnectionPromise = null;
+                state.agentState = "running";
+                state.agentName =
+                    newRuntime.character.name ?? resolveDefaultAgentName(state.config);
+                state.model = detectRuntimeModel(newRuntime);
+                state.startedAt = Date.now();
+                state.pendingRestartReasons = [];
+                onRuntimeSwapped?.();
+                json(res, {
+                    ok: true,
+                    pendingRestart: false,
+                    status: {
+                        state: state.agentState,
+                        agentName: state.agentName,
+                        model: state.model,
+                        startedAt: state.startedAt,
+                    },
+                });
+            }
+            else {
+                state.agentState = previousState;
+                error(res, "Restart handler returned null — runtime failed to re-initialize", 500);
+            }
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            state.agentState = previousState;
+            error(res, `Restart failed: ${message}`, 500);
+        }
+        return true;
+    }
+    if (method === "POST" && pathname === "/api/agent/reset") {
+        try {
+            if (state.runtime) {
+                await state.runtime.stop();
+                state.runtime = null;
+            }
+            const stateDir = resolveStateDir();
+            const config = loadElizaConfig();
+            const dataDir = resolveResetPgliteDataDir(config, stateDir);
+            if (path.basename(dataDir) !== ".elizadb") {
+                logWarn(`[eliza-api] Refusing to delete unexpected PGlite dir during reset: "${dataDir}"`);
+            }
+            else if (stateDirExists(dataDir)) {
+                removeStateDir(dataDir);
+            }
+            clearPersistedOnboardingConfig(config);
+            saveElizaConfig(config);
+            state.agentState = "stopped";
+            state.agentName = resolveDefaultAgentName(config);
+            state.model = undefined;
+            state.startedAt = undefined;
+            state.config = config;
+            state.chatRoomId = null;
+            state.chatUserId = null;
+            state.chatConnectionReady = null;
+            state.chatConnectionPromise = null;
+            state.pendingRestartReasons = [];
+            state.conversations?.clear();
+            state.activeConversationId = null;
+            state.conversationRestorePromise = null;
+            json(res, { ok: true });
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            error(res, `Reset failed: ${message}`, 500);
+        }
+        return true;
+    }
+    if (method === "POST" && pathname === "/api@elizaos/agent/reset") {
+        try {
+            if (state.runtime) {
+                await state.runtime.stop();
+                state.runtime = null;
+            }
+            const stateDir = resolveStateDir();
+            const resolvedState = resolvePath(stateDir);
+            const home = getHomeDir();
+            const isSafe = isSafeResetStateDir(resolvedState, home);
+            if (!isSafe) {
+                logWarn(`[eliza-api] Refusing to delete unsafe state dir: "${resolvedState}"`);
+                error(res, `Reset aborted: state directory "${resolvedState}" does not appear safe to delete`, 400);
+                return true;
+            }
+            if (stateDirExists(resolvedState)) {
+                removeStateDir(resolvedState);
+            }
+            state.agentState = "stopped";
+            state.agentName = getDefaultStylePreset().name;
+            state.model = undefined;
+            state.startedAt = undefined;
+            state.config = {};
+            state.chatRoomId = null;
+            state.chatUserId = null;
+            state.chatConnectionReady = null;
+            state.chatConnectionPromise = null;
+            state.pendingRestartReasons = [];
+            state.conversations?.clear();
+            state.activeConversationId = null;
+            state.conversationRestorePromise = null;
+            json(res, { ok: true });
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            error(res, `Reset failed: ${message}`, 500);
+        }
+        return true;
+    }
+    return false;
+}

package/packages/agent/src/api/agent-lifecycle-routes.d.ts

@@ -0,0 +1,16 @@
+import type { AgentRuntime } from "@elizaos/core";
+import type { RouteHelpers, RouteRequestMeta } from "./route-helpers.js";
+type AgentStateStatus = "not_started" | "starting" | "running" | "paused" | "stopped" | "restarting" | "error";
+export interface AgentLifecycleRouteState {
+    runtime: AgentRuntime | null;
+    agentState: AgentStateStatus;
+    agentName: string;
+    model: string | undefined;
+    startedAt: number | undefined;
+}
+export interface AgentLifecycleRouteContext extends RouteRequestMeta, Pick<RouteHelpers, "error" | "json" | "readJsonBody"> {
+    state: AgentLifecycleRouteState;
+}
+export declare function handleAgentLifecycleRoutes(ctx: AgentLifecycleRouteContext): Promise<boolean>;
+export {};
+//# sourceMappingURL=agent-lifecycle-routes.d.ts.map

package/packages/agent/src/api/agent-lifecycle-routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-lifecycle-routes.d.ts","sourceRoot":"","sources":["../../../../../src/api/agent-lifecycle-routes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAElD,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEzE,KAAK,gBAAgB,GACjB,aAAa,GACb,UAAU,GACV,SAAS,GACT,QAAQ,GACR,SAAS,GACT,YAAY,GACZ,OAAO,CAAC;AAEZ,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,YAAY,GAAG,IAAI,CAAC;IAC7B,UAAU,EAAE,gBAAgB,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;CAC/B;AAED,MAAM,WAAW,0BACf,SAAQ,gBAAgB,EACtB,IAAI,CAAC,YAAY,EAAE,OAAO,GAAG,MAAM,GAAG,cAAc,CAAC;IACvD,KAAK,EAAE,wBAAwB,CAAC;CACjC;AAED,wBAAsB,0BAA0B,CAC9C,GAAG,EAAE,0BAA0B,GAC9B,OAAO,CAAC,OAAO,CAAC,CA0GlB"}

package/packages/agent/src/api/agent-lifecycle-routes.js

@@ -0,0 +1,94 @@
+import { detectRuntimeModel } from "./agent-model.js";
+export async function handleAgentLifecycleRoutes(ctx) {
+    const { req, res, method, pathname, state, error, json, readJsonBody } = ctx;
+    const runtime = state.runtime;
+    if (method === "POST" && pathname === "/api/agent/start") {
+        state.agentState = "paused";
+        state.startedAt = Date.now();
+        state.model = detectRuntimeModel(state.runtime);
+        json(res, {
+            ok: true,
+            status: {
+                state: state.agentState,
+                agentName: state.agentName,
+                model: state.model,
+                uptime: 0,
+                startedAt: state.startedAt,
+            },
+        });
+        return true;
+    }
+    if (method === "POST" && pathname === "/api/agent/stop") {
+        state.agentState = "stopped";
+        state.startedAt = undefined;
+        state.model = undefined;
+        json(res, {
+            ok: true,
+            status: { state: state.agentState, agentName: state.agentName },
+        });
+        return true;
+    }
+    if (method === "POST" && pathname === "/api/agent/pause") {
+        state.agentState = "paused";
+        json(res, {
+            ok: true,
+            status: {
+                state: state.agentState,
+                agentName: state.agentName,
+                model: state.model,
+                uptime: state.startedAt ? Date.now() - state.startedAt : undefined,
+                startedAt: state.startedAt,
+            },
+        });
+        return true;
+    }
+    if (method === "POST" && pathname === "/api/agent/resume") {
+        state.agentState = "running";
+        json(res, {
+            ok: true,
+            status: {
+                state: state.agentState,
+                agentName: state.agentName,
+                model: state.model,
+                uptime: state.startedAt ? Date.now() - state.startedAt : undefined,
+                startedAt: state.startedAt,
+            },
+        });
+        return true;
+    }
+    if (method === "GET" && pathname === "/api/agent/autonomy") {
+        json(res, { enabled: runtime?.enableAutonomy === true });
+        return true;
+    }
+    if (method === "POST" && pathname === "/api/agent/autonomy") {
+        const body = await readJsonBody(req, res);
+        if (!body)
+            return true;
+        if (typeof body.enabled !== "boolean") {
+            error(res, "enabled must be a boolean", 400);
+            return true;
+        }
+        if (!runtime) {
+            error(res, "Agent runtime is not available", 503);
+            return true;
+        }
+        // Set the property AND call the service method so the batcher
+        // section is actually registered/unregistered.
+        const autonomySvc = runtime.getService?.("AUTONOMY") ?? runtime.getService?.("autonomy");
+        const svcAny = autonomySvc;
+        if (svcAny && typeof svcAny.enableAutonomy === "function") {
+            if (body.enabled) {
+                await svcAny.enableAutonomy();
+            }
+            else {
+                await svcAny.disableAutonomy();
+            }
+        }
+        // Always sync the property — enableAutonomy()/disableAutonomy() set it
+        // internally, but if the service path wasn't taken, set it directly.
+        runtime.enableAutonomy = body.enabled;
+        json(res, { enabled: runtime.enableAutonomy === true });
+        return true;
+    }
+    return false;
+}

package/packages/agent/src/api/agent-model.d.ts

@@ -0,0 +1,5 @@
+import type { AgentRuntime } from "@elizaos/core";
+import type { ElizaConfig } from "../config/config.js";
+export declare function detectRuntimeModel(runtime: AgentRuntime | null, config?: Pick<ElizaConfig, "deploymentTarget" | "serviceRouting" | "agents">): string | undefined;
+export declare function resolveProviderFromModel(model: string): string | null;
+//# sourceMappingURL=agent-model.d.ts.map