@elizaos/agent 2.0.0-alpha.98 → 2.0.0-beta.2

package/packages/agent/src/services/registry-client-types.d.ts

@@ -1,23 +1,53 @@
-export interface RegistryAppViewerMeta {
-    url: string;
-    embedParams?: Record<string, string>;
-    postMessageAuth?: boolean;
-    sandbox?: string;
-}
-export interface AppUiExtensionConfig {
-    detailPanelId: string;
-}
+import type { AppSessionConfig, AppSessionFeature, AppSessionMode, AppUiExtensionConfig, AppViewerConfig, RegistryAppInfo } from "@elizaos/shared";
+export type RegistryAppViewerMeta = Omit<AppViewerConfig, "authMessage">;
+export type RegistryAppSessionMode = AppSessionMode;
+export type RegistryAppSessionFeature = AppSessionFeature;
+export type RegistryAppSessionMeta = AppSessionConfig;
+export type { AppUiExtensionConfig, RegistryAppInfo };
 export interface RegistryAppMeta {
     displayName: string;
     category: string;
     launchType: string;
     launchUrl: string | null;
     icon: string | null;
+    /**
+     * URL or package-relative path to a full-card hero image. Apps declare
+     * this in `package.json` → `elizaos.app.heroImage` as a relative path
+     * (e.g. `"assets/hero.png"`); the runtime resolves it to a served
+     * URL before surfacing the field on `RegistryAppInfo`, and falls back
+     * to generated `/api/apps/hero/<slug>` artwork when an app ships none.
+     */
+    heroImage: string | null;
     capabilities: string[];
     minPlayers: number | null;
     maxPlayers: number | null;
+    runtimePlugin?: string;
+    bridgeExport?: string;
     uiExtension?: AppUiExtensionConfig;
     viewer?: RegistryAppViewerMeta;
+    session?: RegistryAppSessionMeta;
+    /**
+     * If true, the app is a developer-tooling surface (logs, trajectory
+     * viewer, etc.) and is hidden from the main UI unless Developer Mode is
+     * enabled in Settings. The server exposes the flag here; the client
+     * gates the render.
+     */
+    developerOnly?: boolean;
+    /**
+     * Controls whether the app appears in the user-facing app store/catalog.
+     * Defaults to true. Set to false for apps that auto-install or are
+     * surfaced only via direct deep-links. The server exposes the flag;
+     * the client gates the render.
+     */
+    visibleInAppStore?: boolean;
+    /**
+     * If true, the app declares itself as the default landing tab for the
+     * shell. Set via `package.json` → `elizaos.app.mainTab`. Exactly one
+     * installed app should declare this; if multiple do, the shell picks
+     * the first one deterministically and logs a warning. Consumed by
+     * `getMainTabApp()` in `@elizaos/app-core` at boot.
+     */
+    mainTab?: boolean;
 }
 export interface RegistryPluginInfo {
     name: string;
@@ -48,37 +78,6 @@ export interface RegistryPluginInfo {
     kind?: string;
     appMeta?: RegistryAppMeta;
 }
-export interface RegistryAppInfo {
-    name: string;
-    displayName: string;
-    description: string;
-    category: string;
-    launchType: string;
-    launchUrl: string | null;
-    icon: string | null;
-    capabilities: string[];
-    stars: number;
-    repository: string;
-    latestVersion: string | null;
-    supports: {
-        v0: boolean;
-        v1: boolean;
-        v2: boolean;
-    };
-    npm: {
-        package: string;
-        v0Version: string | null;
-        v1Version: string | null;
-        v2Version: string | null;
-    };
-    uiExtension?: AppUiExtensionConfig;
-    viewer?: {
-        url: string;
-        embedParams?: Record<string, string>;
-        postMessageAuth?: boolean;
-        sandbox?: string;
-    };
-}
 export interface RegistrySearchResult {
     name: string;
     description: string;

package/packages/agent/src/services/registry-client-types.d.ts.map

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

package/packages/agent/src/services/registry-client.d.ts

@@ -6,9 +6,9 @@
  *
  * @module services/registry-client
  */
-import type { RegistryEndpoint } from "../config/types.eliza.js";
-import type { RegistryAppInfo, RegistryPluginInfo, RegistryPluginListItem, RegistrySearchResult } from "./registry-client-types.js";
-export type { AppUiExtensionConfig, RegistryAppInfo, RegistryAppMeta, RegistryAppViewerMeta, RegistryPluginInfo, RegistryPluginListItem, RegistrySearchResult, } from "./registry-client-types.js";
+import type { RegistryEndpoint } from "../config/types.eliza.ts";
+import type { RegistryAppInfo, RegistryPluginInfo, RegistryPluginListItem, RegistrySearchResult } from "./registry-client-types.ts";
+export type { AppUiExtensionConfig, RegistryAppInfo, RegistryAppMeta, RegistryAppViewerMeta, RegistryPluginInfo, RegistryPluginListItem, RegistrySearchResult, } from "./registry-client-types.ts";
 /** Return the list of custom registry endpoints from config. */
 export declare function getConfiguredEndpoints(): RegistryEndpoint[];
 /** Add a custom registry endpoint. Blocks duplicate URLs. */

package/packages/agent/src/services/registry-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry-client.d.ts","sourceRoot":"","sources":["../../../../../src/services/registry-client.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AA0BjE,OAAO,KAAK,EACV,eAAe,EACf,kBAAkB,EAClB,sBAAsB,EACtB,oBAAoB,EACrB,MAAM,4BAA4B,CAAC;AAepC,YAAY,EACV,oBAAoB,EACpB,eAAe,EACf,eAAe,EACf,qBAAqB,EACrB,kBAAkB,EAClB,sBAAsB,EACtB,oBAAoB,GACrB,MAAM,4BAA4B,CAAC;AA6EpC,gEAAgE;AAChE,wBAAgB,sBAAsB,IAAI,gBAAgB,EAAE,CAO3D;AAED,6DAA6D;AAC7D,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAkBpE;AAED,2EAA2E;AAC3E,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAiBxD;AAED,2CAA2C;AAC3C,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAW1E;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAEtD;AAMD,4DAA4D;AAC5D,wBAAsB,kBAAkB,IAAI,OAAO,CACjD,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAChC,CA2BA;AAED,kCAAkC;AAClC,wBAAsB,eAAe,IAAI,OAAO,CAC9C,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAChC,CAQA;AAED,yEAAyE;AACzE,wBAAsB,aAAa,CACjC,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAWpC;AAED,8EAA8E;AAC9E,wBAAsB,aAAa,CACjC,KAAK,EAAE,MAAM,EACb,KAAK,SAAK,GACT,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAIjC;AAED,gCAAgC;AAChC,wBAAsB,QAAQ,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC,CAY3D;AAED,sCAAsC;AACtC,wBAAsB,UAAU,CAC9B,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAMjC;AAED,4BAA4B;AAC5B,wBAAsB,UAAU,CAC9B,KAAK,EAAE,MAAM,EACb,KAAK,SAAK,GACT,OAAO,CAAC,eAAe,EAAE,CAAC,CAmB5B;AAED,kDAAkD;AAClD,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,sBAAsB,EAAE,CAAC,CAY3E;AAED,uCAAuC;AACvC,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,MAAM,EACb,KAAK,SAAK,GACT,OAAO,CAAC,sBAAsB,EAAE,CAAC,CAMnC"}
+{"version":3,"file":"registry-client.d.ts","sourceRoot":"","sources":["../../../../../src/services/registry-client.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AA6BjE,OAAO,KAAK,EACV,eAAe,EACf,kBAAkB,EAClB,sBAAsB,EACtB,oBAAoB,EACrB,MAAM,4BAA4B,CAAC;AA6BpC,YAAY,EACV,oBAAoB,EACpB,eAAe,EACf,eAAe,EACf,qBAAqB,EACrB,kBAAkB,EAClB,sBAAsB,EACtB,oBAAoB,GACrB,MAAM,4BAA4B,CAAC;AAgJpC,gEAAgE;AAChE,wBAAgB,sBAAsB,IAAI,gBAAgB,EAAE,CAY3D;AAED,6DAA6D;AAC7D,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAkBpE;AAED,2EAA2E;AAC3E,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAiBxD;AAED,2CAA2C;AAC3C,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAW1E;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAEtD;AAMD,4DAA4D;AAC5D,wBAAsB,kBAAkB,IAAI,OAAO,CACjD,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAChC,CAiEA;AAED,kCAAkC;AAClC,wBAAsB,eAAe,IAAI,OAAO,CAC9C,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAChC,CAQA;AAED,yEAAyE;AACzE,wBAAsB,aAAa,CACjC,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAWpC;AAED,8EAA8E;AAC9E,wBAAsB,aAAa,CACjC,KAAK,EAAE,MAAM,EACb,KAAK,SAAK,GACT,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAIjC;AAED,gCAAgC;AAChC,wBAAsB,QAAQ,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC,CAY3D;AAED,sCAAsC;AACtC,wBAAsB,UAAU,CAC9B,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAMjC;AAED,4BAA4B;AAC5B,wBAAsB,UAAU,CAC9B,KAAK,EAAE,MAAM,EACb,KAAK,SAAK,GACT,OAAO,CAAC,eAAe,EAAE,CAAC,CAmB5B;AAED,kDAAkD;AAClD,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,sBAAsB,EAAE,CAAC,CAY3E;AAED,uCAAuC;AACvC,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,MAAM,EACb,KAAK,SAAK,GACT,OAAO,CAAC,sBAAsB,EAAE,CAAC,CAMnC"}

package/packages/agent/src/services/registry-client.js

@@ -7,14 +7,14 @@
  * @module services/registry-client
  */
 import fs from "node:fs/promises";
-import os from "node:os";
 import path from "node:path";
 import { logger } from "@elizaos/core";
 import { loadElizaConfig, saveElizaConfig } from "../config/config.js";
+import { resolveStateDir } from "../config/paths.js";
 import { LOCAL_APP_DEFAULT_SANDBOX, resolveAppOverride, sanitizeSandbox, } from "./registry-client-app-meta.js";
 import { isDefaultEndpoint as isDefaultEndpointForUrl, mergeCustomEndpoints, normaliseEndpointUrl, parseRegistryEndpointUrl, } from "./registry-client-endpoints.js";
 import { applyLocalWorkspaceApps, applyNodeModulePlugins, } from "./registry-client-local.js";
-import { fetchFromNetwork as fetchRegistryFromNetwork } from "./registry-client-network.js";
+import { fetchFromNetwork as fetchRegistryFromNetwork, isExpectedRegistryNetworkFallback, } from "./registry-client-network.js";
 import { getPluginInfoFromRegistry, normalizePluginLookupAlias, scoreEntries, toAppEntry, toAppInfo, toPluginListItem, toSearchResults, } from "./registry-client-queries.js";
 // ---------------------------------------------------------------------------
 // Constants
@@ -22,10 +22,26 @@ import { getPluginInfoFromRegistry, normalizePluginLookupAlias, scoreEntries, to
 const GENERATED_REGISTRY_URL = "https://raw.githubusercontent.com/elizaos-plugins/registry/next/generated-registry.json";
 const INDEX_REGISTRY_URL = "https://raw.githubusercontent.com/elizaos-plugins/registry/next/index.json";
 const CACHE_TTL_MS = 3_600_000; // 1 hour
+const BLOCKED_REGISTRY_PLUGIN_NAMES = new Set([
+    "@elizaos/app-agent-town",
+    "@elizaos/app-dungeons",
+    "@elizaos/app-dungeons-and-daemons",
+]);
+const BLOCKED_REGISTRY_PLUGIN_REPOS = new Set([
+    "agent-town/agent-town",
+    "lalalune/dungeons",
+    "lalalune/dungeons-and-daemons",
+]);
+const BLOCKED_REGISTRY_APP_DISPLAY_NAMES = new Set([
+    "agent-town",
+    "dungeons-and-daemons",
+]);
 // ---------------------------------------------------------------------------
 // Cache state
 // ---------------------------------------------------------------------------
 let memoryCache = null;
+let registryLoadPromise = null;
+const LOCAL_FALLBACK_CACHE_TTL_MS = 5 * 60_000;
 // ---------------------------------------------------------------------------
 // Network fetch + parse (inlined wire types — not exported)
 // ---------------------------------------------------------------------------
@@ -40,16 +56,58 @@ async function fetchFromNetwork() {
         });
     }
     catch (err) {
-        logger.warn(`[registry-client] generated-registry/index fallback failed: ${err instanceof Error ? err.message : String(err)}`);
+        if (!isExpectedRegistryNetworkFallback(err)) {
+            logger.warn(`[registry-client] generated-registry/index fallback failed: ${String(err)}`);
+        }
         throw err;
     }
 }
+async function buildLocalRegistrySnapshot() {
+    const plugins = new Map();
+    await applyLocalWorkspaceApps(plugins);
+    await applyNodeModulePlugins(plugins);
+    return plugins;
+}
 // ---------------------------------------------------------------------------
 // File cache
 // ---------------------------------------------------------------------------
 function cacheFilePath() {
-    const base = process.env.ELIZA_STATE_DIR?.trim() || path.join(os.homedir(), ".eliza");
-    return path.join(base, "cache", "registry.json");
+    return path.join(resolveStateDir(), "cache", "registry.json");
+}
+function normalizeRegistryFilterKey(value) {
+    return (value ?? "")
+        .trim()
+        .toLowerCase()
+        .replace(/\s{0,32}&\s{0,32}/g, " and ")
+        .replace(/[^a-z0-9/]+/g, "-")
+        .replace(/^-+|-+$/g, "");
+}
+function isBlockedRegistryPlugin(info) {
+    const name = normalizeRegistryFilterKey(info.name);
+    if (BLOCKED_REGISTRY_PLUGIN_NAMES.has(name)) {
+        return true;
+    }
+    const npmPackage = normalizeRegistryFilterKey(info.npm.package);
+    if (BLOCKED_REGISTRY_PLUGIN_NAMES.has(npmPackage)) {
+        return true;
+    }
+    const gitRepo = normalizeRegistryFilterKey(info.gitRepo);
+    if (BLOCKED_REGISTRY_PLUGIN_REPOS.has(gitRepo)) {
+        return true;
+    }
+    const displayName = normalizeRegistryFilterKey(info.appMeta?.displayName);
+    return BLOCKED_REGISTRY_APP_DISPLAY_NAMES.has(displayName);
+}
+function filterBlockedRegistryPlugins(plugins) {
+    let removed = false;
+    for (const [name, info] of plugins.entries()) {
+        if (!isBlockedRegistryPlugin(info)) {
+            continue;
+        }
+        plugins.delete(name);
+        removed = true;
+    }
+    return removed;
 }
 async function readFileCache() {
     try {
@@ -59,7 +117,11 @@ async function readFileCache() {
             return null;
         if (Date.now() - parsed.fetchedAt > CACHE_TTL_MS)
             return null;
-        return new Map(parsed.plugins);
+        const plugins = new Map(parsed.plugins);
+        if (filterBlockedRegistryPlugins(plugins)) {
+            writeFileCache(plugins).catch((err) => logger.warn(`[registry-client] Cache rewrite failed: ${String(err)}`));
+        }
+        return plugins;
     }
     catch {
         return null;
@@ -67,8 +129,13 @@ async function readFileCache() {
 }
 async function writeFileCache(plugins) {
     const filePath = cacheFilePath();
+    const persistedPlugins = new Map(plugins);
+    filterBlockedRegistryPlugins(persistedPlugins);
     await fs.mkdir(path.dirname(filePath), { recursive: true });
-    await fs.writeFile(filePath, JSON.stringify({ fetchedAt: Date.now(), plugins: [...plugins.entries()] }), "utf-8");
+    await fs.writeFile(filePath, JSON.stringify({
+        fetchedAt: Date.now(),
+        plugins: [...persistedPlugins.entries()],
+    }), "utf-8");
 }
 // ---------------------------------------------------------------------------
 // Multi-endpoint management
@@ -79,7 +146,8 @@ export function getConfiguredEndpoints() {
         const cfg = loadElizaConfig();
         return cfg.plugins?.registryEndpoints ?? [];
     }
-    catch {
+    catch (err) {
+        logger.warn(`[registry-client] Failed to load config for custom endpoints: ${err instanceof Error ? err.message : String(err)}`);
         return [];
     }
 }
@@ -145,7 +213,8 @@ export function isDefaultEndpoint(url) {
 // ---------------------------------------------------------------------------
 /** Get all plugins. Resolution: memory → file → network. */
 export async function getRegistryPlugins() {
-    if (memoryCache && Date.now() - memoryCache.fetchedAt < CACHE_TTL_MS) {
+    if (memoryCache &&
+        Date.now() - memoryCache.fetchedAt < (memoryCache.ttlMs ?? CACHE_TTL_MS)) {
         return memoryCache.plugins;
     }
     const fromFile = await readFileCache();
@@ -153,16 +222,47 @@ export async function getRegistryPlugins() {
         await applyLocalWorkspaceApps(fromFile);
         await applyNodeModulePlugins(fromFile);
         await mergeCustomEndpoints(fromFile, getConfiguredEndpoints());
+        filterBlockedRegistryPlugins(fromFile);
         memoryCache = { plugins: fromFile, fetchedAt: Date.now() };
         return fromFile;
     }
-    logger.info("[registry-client] Fetching plugin registry from next branch...");
-    const plugins = await fetchFromNetwork();
-    await mergeCustomEndpoints(plugins, getConfiguredEndpoints());
-    logger.info(`[registry-client] Loaded ${plugins.size} plugins`);
-    memoryCache = { plugins, fetchedAt: Date.now() };
-    writeFileCache(plugins).catch((err) => logger.warn(`[registry-client] Cache write failed: ${err instanceof Error ? err.message : String(err)}`));
-    return plugins;
+    if (registryLoadPromise) {
+        return registryLoadPromise;
+    }
+    registryLoadPromise = (async () => {
+        logger.info("[registry-client] Fetching plugin registry from next branch...");
+        let plugins;
+        let usedLocalFallback = false;
+        try {
+            plugins = await fetchFromNetwork();
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            if (isExpectedRegistryNetworkFallback(err)) {
+                logger.debug(`[registry-client] Remote registry unavailable; using local registry discovery: ${message}`);
+            }
+            else {
+                logger.warn(`[registry-client] Falling back to local registry discovery: ${message}`);
+            }
+            plugins = await buildLocalRegistrySnapshot();
+            usedLocalFallback = true;
+        }
+        await mergeCustomEndpoints(plugins, getConfiguredEndpoints());
+        filterBlockedRegistryPlugins(plugins);
+        logger.info(`[registry-client] Loaded ${plugins.size} plugins`);
+        memoryCache = {
+            plugins,
+            fetchedAt: Date.now(),
+            ttlMs: usedLocalFallback ? LOCAL_FALLBACK_CACHE_TTL_MS : CACHE_TTL_MS,
+        };
+        if (!usedLocalFallback) {
+            writeFileCache(plugins).catch((err) => logger.warn(`[registry-client] Cache write failed: ${String(err)}`));
+        }
+        return plugins;
+    })().finally(() => {
+        registryLoadPromise = null;
+    });
+    return registryLoadPromise;
 }
 /** Force-refresh from network. */
 export async function refreshRegistry() {

package/packages/agent/src/services/relationships-graph.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Agent-side wiring for the merged relationships graph in `@elizaos/core`.
+ * Import graph types and helpers from `@elizaos/core` directly.
+ */
+import type { IAgentRuntime, RelationshipsGraphService } from "@elizaos/core";
+export { type ClusterMemoriesQuery, type ClusterSearchQuery, createNativeRelationshipsGraphService, getMemoriesForCluster, type RelationshipsConversationMessage, type RelationshipsConversationSnippet, type RelationshipsFactExtractedInformation, type RelationshipsFactProvenance, type RelationshipsGraphEdge, type RelationshipsGraphQuery, type RelationshipsGraphService, type RelationshipsGraphSnapshot, type RelationshipsGraphStats, type RelationshipsIdentityEdge, type RelationshipsIdentityHandle, type RelationshipsIdentitySummary, type RelationshipsMergeCandidate, type RelationshipsPersonDetail, type RelationshipsPersonFact, type RelationshipsPersonSummary, type RelationshipsProfile, type RelationshipsRelevantMemory, type RelationshipsServiceLike, type RelationshipsUserPersonalityPreference, searchMemoriesForCluster, } from "@elizaos/core";
+/**
+ * Resolve the merged RelationshipsService and wire its agent-side owner
+ * resolvers. Compatibility wrapper for the old factory; prefer
+ * `runtime.getService("relationships")` directly.
+ */
+export declare function resolveRelationshipsGraphService(runtime: IAgentRuntime): Promise<RelationshipsGraphService | null>;
+//# sourceMappingURL=relationships-graph.d.ts.map

package/packages/agent/src/services/relationships-graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relationships-graph.d.ts","sourceRoot":"","sources":["../../../../../src/services/relationships-graph.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACV,aAAa,EACb,yBAAyB,EAE1B,MAAM,eAAe,CAAC;AAIvB,OAAO,EACL,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACvB,qCAAqC,EACrC,qBAAqB,EACrB,KAAK,gCAAgC,EACrC,KAAK,gCAAgC,EACrC,KAAK,qCAAqC,EAC1C,KAAK,2BAA2B,EAChC,KAAK,sBAAsB,EAC3B,KAAK,uBAAuB,EAC5B,KAAK,yBAAyB,EAC9B,KAAK,0BAA0B,EAC/B,KAAK,uBAAuB,EAC5B,KAAK,yBAAyB,EAC9B,KAAK,2BAA2B,EAChC,KAAK,4BAA4B,EACjC,KAAK,2BAA2B,EAChC,KAAK,yBAAyB,EAC9B,KAAK,uBAAuB,EAC5B,KAAK,0BAA0B,EAC/B,KAAK,oBAAoB,EACzB,KAAK,2BAA2B,EAChC,KAAK,wBAAwB,EAC7B,KAAK,sCAAsC,EAC3C,wBAAwB,GACzB,MAAM,eAAe,CAAC;AAqBvB;;;;GAIG;AACH,wBAAsB,gCAAgC,CACpD,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,yBAAyB,GAAG,IAAI,CAAC,CA2B3C"}

package/packages/agent/src/services/relationships-graph.js

@@ -0,0 +1,38 @@
+/**
+ * Agent-side wiring for the merged relationships graph in `@elizaos/core`.
+ * Import graph types and helpers from `@elizaos/core` directly.
+ */
+import { resolveOwnerEntityId } from "../runtime/owner-entity.js";
+import { fetchConfiguredOwnerName } from "./owner-name.js";
+export { createNativeRelationshipsGraphService, getMemoriesForCluster, searchMemoriesForCluster, } from "@elizaos/core";
+function isRelationshipsServiceWithGraph(service) {
+    return typeof service === "object" && service !== null;
+}
+/**
+ * Resolve the merged RelationshipsService and wire its agent-side owner
+ * resolvers. Compatibility wrapper for the old factory; prefer
+ * `runtime.getService("relationships")` directly.
+ */
+export async function resolveRelationshipsGraphService(runtime) {
+    const runtimeWithFeatures = runtime;
+    if (typeof runtimeWithFeatures.isRelationshipsEnabled === "function" &&
+        !runtimeWithFeatures.isRelationshipsEnabled() &&
+        typeof runtimeWithFeatures.enableRelationships === "function") {
+        await runtimeWithFeatures.enableRelationships();
+    }
+    const service = runtime.getService("relationships");
+    if (!service || typeof service !== "object") {
+        return null;
+    }
+    if (!isRelationshipsServiceWithGraph(service)) {
+        return null;
+    }
+    const graphService = service;
+    if (typeof graphService.setGraphResolvers === "function") {
+        graphService.setGraphResolvers({
+            resolveOwnerEntityId: (rt) => resolveOwnerEntityId(rt),
+            fetchConfiguredOwnerName: () => fetchConfiguredOwnerName(),
+        });
+    }
+    return graphService;
+}

package/packages/agent/src/services/remote-signing-service.d.ts

@@ -2,8 +2,8 @@
  * Remote signing service. Private keys stay on the host;
  * sandboxed agents submit unsigned tx → policy check → sign → return.
  */
-import type { SandboxAuditLog } from "../security/audit-log";
-import { type PolicyDecision, type SigningPolicy, type SigningRequest } from "./signing-policy";
+import type { SandboxAuditLog } from "../security/audit-log.ts";
+import { type PolicyDecision, type SigningPolicy, type SigningRequest } from "./signing-policy.ts";
 export interface SignerBackend {
     getAddress(): Promise<string>;
     signMessage(message: string): Promise<string>;

package/packages/agent/src/services/remote-signing-service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"remote-signing-service.d.ts","sourceRoot":"","sources":["../../../../../src/services/remote-signing-service.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,aAAa,EAElB,KAAK,cAAc,EACpB,MAAM,kBAAkB,CAAC;AAE1B,MAAM,WAAW,aAAa;IAC5B,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAC9B,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC9C,eAAe,CAAC,EAAE,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAC3D;AAED,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,cAAc,CAAC;IAC/B,cAAc,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,cAAc,CAAC;IACxB,QAAQ,EAAE,cAAc,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,0BAA0B;IACzC,MAAM,EAAE,aAAa,CAAC;IACtB,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,eAAe,CAAyB;IAChD,OAAO,CAAC,QAAQ,CAAC,CAAkB;IACnC,OAAO,CAAC,gBAAgB,CAAsC;IAC9D,OAAO,CAAC,iBAAiB,CAAS;gBAEtB,MAAM,EAAE,0BAA0B;IAOxC,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;IAI7B,oBAAoB,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IA4DrE,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAgC/D,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAgBzC,mBAAmB,IAAI,eAAe,EAAE;IAWxC,YAAY,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI;IASzC,SAAS,IAAI,aAAa;YAIZ,WAAW;CAyD1B"}
+{"version":3,"file":"remote-signing-service.d.ts","sourceRoot":"","sources":["../../../../../src/services/remote-signing-service.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,aAAa,EAElB,KAAK,cAAc,EACpB,MAAM,qBAAqB,CAAC;AAE7B,MAAM,WAAW,aAAa;IAC5B,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAC9B,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC9C,eAAe,CAAC,EAAE,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAC3D;AAED,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,cAAc,CAAC;IAC/B,cAAc,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,cAAc,CAAC;IACxB,QAAQ,EAAE,cAAc,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,0BAA0B;IACzC,MAAM,EAAE,aAAa,CAAC;IACtB,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,eAAe,CAAyB;IAChD,OAAO,CAAC,QAAQ,CAAC,CAAkB;IACnC,OAAO,CAAC,gBAAgB,CAAsC;IAC9D,OAAO,CAAC,iBAAiB,CAAS;gBAEtB,MAAM,EAAE,0BAA0B;IAOxC,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;IAI7B,oBAAoB,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IA4DrE,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAgC/D,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAgBzC,mBAAmB,IAAI,eAAe,EAAE;IAWxC,YAAY,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI;IASzC,SAAS,IAAI,aAAa;YAIZ,WAAW;CAyD1B"}

package/packages/agent/src/services/remote-signing-service.js

@@ -2,7 +2,7 @@
  * Remote signing service. Private keys stay on the host;
  * sandboxed agents submit unsigned tx → policy check → sign → return.
  */
-import { SigningPolicyEvaluator, } from "./signing-policy";
+import { SigningPolicyEvaluator, } from "./signing-policy.js";
 export class RemoteSigningService {
     signer;
     policyEvaluator;
@@ -164,7 +164,7 @@ export class RemoteSigningService {
             };
         }
         catch (err) {
-            const errorMsg = err instanceof Error ? err.message : String(err);
+            const errorMsg = String(err);
             this.auditLog?.record({
                 type: "signing_request_rejected",
                 summary: `Signing failed for ${request.requestId}: ${errorMsg}`,

package/packages/agent/src/services/research-task-executor.d.ts

@@ -0,0 +1,14 @@
+import { type IAgentRuntime } from "@elizaos/core";
+import type { TaskExecutor, TaskResult, TaskSpec } from "./task-executor.ts";
+/**
+ * Decomposes research questions into sub-questions, answers each via the
+ * runtime's LLM, and synthesizes a final report.
+ */
+export declare class ResearchTaskExecutor implements TaskExecutor {
+    readonly type = "research";
+    readonly description = "Decomposes research questions and produces analysis artifacts";
+    canHandle(spec: TaskSpec, _runtime: IAgentRuntime): boolean;
+    execute(spec: TaskSpec, runtime: IAgentRuntime): Promise<TaskResult>;
+    abort(_taskId: string): Promise<void>;
+}
+//# sourceMappingURL=research-task-executor.d.ts.map

package/packages/agent/src/services/research-task-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"research-task-executor.d.ts","sourceRoot":"","sources":["../../../../../src/services/research-task-executor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,aAAa,EAAa,MAAM,eAAe,CAAC;AAC9D,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAK7E;;;GAGG;AACH,qBAAa,oBAAqB,YAAW,YAAY;IACvD,QAAQ,CAAC,IAAI,cAAc;IAC3B,QAAQ,CAAC,WAAW,mEAC8C;IAElE,SAAS,CAAC,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,aAAa,GAAG,OAAO;IAKrD,OAAO,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,UAAU,CAAC;IAyIpE,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAI5C"}

package/packages/agent/src/services/research-task-executor.js

@@ -0,0 +1,138 @@
+import { ModelType } from "@elizaos/core";
+const RESEARCH_PATTERNS = /\b(research|investigate|analyze|find out|look into|explore|summarize|compare|evaluate|review|study|assess)\b/i;
+/**
+ * Decomposes research questions into sub-questions, answers each via the
+ * runtime's LLM, and synthesizes a final report.
+ */
+export class ResearchTaskExecutor {
+    type = "research";
+    description = "Decomposes research questions and produces analysis artifacts";
+    canHandle(spec, _runtime) {
+        if (spec.type === "research")
+            return true;
+        return RESEARCH_PATTERNS.test(spec.description);
+    }
+    async execute(spec, runtime) {
+        const startTime = Date.now();
+        try {
+            try {
+                const researchResult = (await runtime.useModel(ModelType.RESEARCH, {
+                    input: spec.description,
+                    tools: [{ type: "web_search_preview" }],
+                    background: true,
+                    reasoningSummary: "auto",
+                }));
+                const output = typeof researchResult === "string"
+                    ? researchResult
+                    : (researchResult.text ?? "");
+                if (output.trim().length > 0) {
+                    return {
+                        taskId: spec.id,
+                        success: true,
+                        output,
+                        durationMs: Date.now() - startTime,
+                    };
+                }
+            }
+            catch {
+                // Fall through to the sequential synthesis path when the runtime
+                // does not expose a RESEARCH model or the provider rejects it.
+            }
+            // Step 1: Decompose the research question into sub-questions
+            const decomposition = await runtime.useModel(ModelType.TEXT_LARGE, {
+                prompt: [
+                    "Decompose this research question into 3-5 focused sub-questions",
+                    "that can be answered independently:",
+                    "",
+                    spec.description,
+                    "",
+                    "Return each sub-question on its own line, one per line. No numbering, no bullets, no prose.",
+                ].join("\n"),
+            });
+            let subQuestions;
+            try {
+                // Parse line-delimited questions from the response.
+                // Strip markdown fences and numbering if the model adds them.
+                let raw = typeof decomposition === "string"
+                    ? decomposition
+                    : String(decomposition);
+                const fenceMatch = raw.match(/```(?:\w+)?\s*\n?([\s\S]*?)\n?\s*```/);
+                if (fenceMatch)
+                    raw = fenceMatch[1];
+                // Try line-based parsing first (preferred)
+                const lines = raw
+                    .split(/\r?\n/)
+                    .map((line) => line
+                    .replace(/^\s{0,32}(?:\d{1,8}[.)]\s{0,32}|-\s{0,32}|\*\s{0,32})/, "")
+                    .trim())
+                    .filter((line) => line.length > 0);
+                if (lines.length >= 2) {
+                    subQuestions = lines;
+                }
+                else {
+                    // Fallback: try JSON array parse for backwards compat
+                    const jsonParsed = JSON.parse(raw.trim());
+                    subQuestions = Array.isArray(jsonParsed)
+                        ? jsonParsed.filter((q) => typeof q === "string")
+                        : [spec.description];
+                }
+                if (subQuestions.length === 0)
+                    subQuestions = [spec.description];
+            }
+            catch {
+                subQuestions = [spec.description];
+            }
+            // Step 2: Answer each sub-question
+            const answers = [];
+            for (const question of subQuestions) {
+                const answer = await runtime.useModel(ModelType.TEXT_LARGE, {
+                    prompt: [
+                        "Answer this research question concisely but thoroughly:",
+                        "",
+                        question,
+                        "",
+                        `Context: This is part of a larger research task: "${spec.description}"`,
+                    ].join("\n"),
+                });
+                answers.push({
+                    question,
+                    answer: typeof answer === "string" ? answer : String(answer),
+                });
+            }
+            // Step 3: Synthesize into a final report
+            const findingsBlock = answers
+                .map((a, i) => `${i + 1}. Q: ${a.question}\n   A: ${a.answer}`)
+                .join("\n\n");
+            const synthesis = await runtime.useModel(ModelType.TEXT_LARGE, {
+                prompt: [
+                    "Synthesize these research findings into a coherent report:",
+                    "",
+                    `Original question: ${spec.description}`,
+                    "",
+                    `Findings:\n${findingsBlock}`,
+                    "",
+                    "Provide a structured summary with key findings, conclusions, and any caveats.",
+                ].join("\n"),
+            });
+            const report = typeof synthesis === "string" ? synthesis : String(synthesis);
+            return {
+                taskId: spec.id,
+                success: true,
+                output: report,
+                durationMs: Date.now() - startTime,
+            };
+        }
+        catch (error) {
+            return {
+                taskId: spec.id,
+                success: false,
+                error: error instanceof Error ? error.message : String(error),
+                durationMs: Date.now() - startTime,
+            };
+        }
+    }
+    async abort(_taskId) {
+        // Research tasks are sequential LLM calls — no persistent process to abort.
+        // Could add cancellation token support in the future.
+    }
+}