@elizaos/agent 2.0.0-alpha.173 → 2.0.0-alpha.192

package/packages/agent/src/runtime/first-time-setup.js

@@ -18,12 +18,13 @@
  *
  * @module first-time-setup
  */
+import { getStylePresets } from "@elizaos/shared/onboarding-presets";
 import { persistConfigEnv } from "../api/config-env.js";
+import { CLOUD_EVM_ADDRESS_ENV_KEY, CLOUD_SOLANA_ADDRESS_ENV_KEY, WALLET_SOURCE_EVM_ENV_KEY, WALLET_SOURCE_SOLANA_ENV_KEY, } from "../api/wallet.js";
 import { saveElizaConfig } from "../config/config.js";
 import { isCloudWalletEnabled } from "../config/feature-flags.js";
 import { migrateLegacyRuntimeConfig } from "../contracts/onboarding.js";
 import { buildDefaultElizaCloudServiceRouting, buildElizaCloudServiceRoute, } from "../contracts/service-routing.js";
-import { getStylePresets } from "../onboarding-presets.js";
 import { pickRandomNames } from "./onboarding-names.js";
 // ---------------------------------------------------------------------------
 // Helpers (private)
@@ -105,9 +106,6 @@ function cancelOnboarding() {
     _clack?.cancel("Maybe next time!");
     process.exit(0);
 }
-// ---------------------------------------------------------------------------
-// Main function
-// ---------------------------------------------------------------------------
 /**
  * Read whether the runtime config holds cached cloud-wallet descriptors.
  * Uses defensive accessors because `wallet.cloud` is introduced by the
@@ -144,17 +142,14 @@ function readCloudWalletAddress(config, chain) {
  */
 function readUserPrimarySelection(config) {
     const wallet = config.wallet;
-    const raw = wallet && typeof wallet === "object"
-        ? wallet.primary
-        : undefined;
+    const raw = wallet?.primary;
     const result = { evm: null, solana: null };
-    if (raw && typeof raw === "object" && !Array.isArray(raw)) {
-        const record = raw;
-        if (record.evm === "cloud" || record.evm === "local") {
-            result.evm = record.evm;
+    if (raw) {
+        if (raw.evm === "cloud" || raw.evm === "local") {
+            result.evm = raw.evm;
         }
-        if (record.solana === "cloud" || record.solana === "local") {
-            result.solana = record.solana;
+        if (raw.solana === "cloud" || raw.solana === "local") {
+            result.solana = raw.solana;
         }
     }
     return result;
@@ -187,25 +182,25 @@ export async function bindCloudProvider(config) {
     const shouldBindSolana = Boolean(cloud.solana) && userPrimary.solana !== "local";
     if (shouldBindEvm &&
         evmAddress &&
-        process.env.MILADY_CLOUD_EVM_ADDRESS !== evmAddress) {
-        await persistConfigEnv("MILADY_CLOUD_EVM_ADDRESS", evmAddress);
+        process.env[CLOUD_EVM_ADDRESS_ENV_KEY] !== evmAddress) {
+        await persistConfigEnv(CLOUD_EVM_ADDRESS_ENV_KEY, evmAddress);
     }
     if (shouldBindSolana &&
         solanaAddress &&
-        process.env.MILADY_CLOUD_SOLANA_ADDRESS !== solanaAddress) {
-        await persistConfigEnv("MILADY_CLOUD_SOLANA_ADDRESS", solanaAddress);
+        process.env[CLOUD_SOLANA_ADDRESS_ENV_KEY] !== solanaAddress) {
+        await persistConfigEnv(CLOUD_SOLANA_ADDRESS_ENV_KEY, solanaAddress);
     }
-    // Only bind WALLET_SOURCE_* to cloud if:
-    //   1. User has explicitly set it to "cloud", OR
-    //   2. User has NOT made an explicit choice yet (null = auto-bind as default)
-    // DO NOT bind if user has explicitly set it to "local".
-    if (shouldBindEvm && process.env.WALLET_SOURCE_EVM !== "cloud") {
-        await persistConfigEnv("WALLET_SOURCE_EVM", "cloud");
+    if (shouldBindEvm && process.env[WALLET_SOURCE_EVM_ENV_KEY] !== "cloud") {
+        await persistConfigEnv(WALLET_SOURCE_EVM_ENV_KEY, "cloud");
     }
-    if (shouldBindSolana && process.env.WALLET_SOURCE_SOLANA !== "cloud") {
-        await persistConfigEnv("WALLET_SOURCE_SOLANA", "cloud");
+    if (shouldBindSolana &&
+        process.env[WALLET_SOURCE_SOLANA_ENV_KEY] !== "cloud") {
+        await persistConfigEnv(WALLET_SOURCE_SOLANA_ENV_KEY, "cloud");
     }
 }
+// ---------------------------------------------------------------------------
+// Main function
+// ---------------------------------------------------------------------------
 export async function runFirstTimeSetup(config) {
     const agentEntry = config.agents?.list?.[0];
     const hasName = Boolean(agentEntry?.name || config.ui?.assistant?.name);

package/packages/agent/src/runtime/index.d.ts

@@ -4,7 +4,7 @@ export * from "./embedding-presets.js";
 export * from "./onboarding-names.js";
 export * from "./plugin-collector.js";
 export * from "./plugin-lifecycle.js";
-export { resolvePlugins } from "./plugin-resolver.js";
+export { getLastFailedPluginNames, resolvePlugins } from "./plugin-resolver.js";
 export * from "./release-plugin-policy.js";
 export * from "./restart.js";
 export * from "./roles.js";

package/packages/agent/src/runtime/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/runtime/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,6BAA6B,CAAC;AAC5C,cAAc,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/runtime/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,OAAO,EAAE,wBAAwB,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAChF,cAAc,4BAA4B,CAAC;AAC3C,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,6BAA6B,CAAC;AAC5C,cAAc,cAAc,CAAC"}

package/packages/agent/src/runtime/index.js

@@ -4,7 +4,7 @@ export * from "./embedding-presets.js";
 export * from "./onboarding-names.js";
 export * from "./plugin-collector.js";
 export * from "./plugin-lifecycle.js";
-export { resolvePlugins } from "./plugin-resolver.js";
+export { getLastFailedPluginNames, resolvePlugins } from "./plugin-resolver.js";
 export * from "./release-plugin-policy.js";
 export * from "./restart.js";
 export * from "./roles.js";

package/packages/agent/src/runtime/plugin-collector.d.ts

@@ -1,4 +1,3 @@
-import type { ElizaConfig } from "../config/config.js";
 /**
  * Legacy package names that were merged or renamed. Config allow-lists and
  * `plugins.installs` may still reference the old id.
@@ -24,15 +23,4 @@ export declare const OPTIONAL_PLUGIN_MAP: Readonly<Record<string, string>>;
  * source, operators assume the framework is broken instead of fixing config/env.
  */
 export type PluginLoadReasons = Map<string, string>;
-/**
- * Collect plugin package names to load from config, env, feature flags, and
- * connector-derived allow-list mutations.
- *
- * @param reasons - When set, records the **first** reason each name was added
- *   (subsequent adds for the same name are ignored). Used by `resolvePlugins`
- *   to annotate benign optional load failures.
- *
- * @internal Exported for testing.
- */
-export declare function collectPluginNames(config: ElizaConfig, reasons?: PluginLoadReasons): Set<string>;
 //# sourceMappingURL=plugin-collector.d.ts.map

package/packages/agent/src/runtime/plugin-collector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin-collector.d.ts","sourceRoot":"","sources":["../../../../../src/runtime/plugin-collector.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AA8BvD;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAKrE;AAQD,wDAAwD;AACxD,eAAO,MAAM,kBAAkB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAsB/D,CAAC;AAEF,yEAAyE;AACzE,eAAO,MAAM,mBAAmB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAmBhE,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CA4ChE,CAAC;AAMF;;;;;;;GAOG;AACH,MAAM,MAAM,iBAAiB,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAEpD;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,WAAW,EACnB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,GAAG,CAAC,MAAM,CAAC,CAqRb"}
+{"version":3,"file":"plugin-collector.d.ts","sourceRoot":"","sources":["../../../../../src/runtime/plugin-collector.ts"],"names":[],"mappings":"AAoDA;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAKrE;AAQD,wDAAwD;AACxD,eAAO,MAAM,kBAAkB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAsB/D,CAAC;AAEF,yEAAyE;AACzE,eAAO,MAAM,mBAAmB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAmBhE,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CA4ChE,CAAC;AAMF;;;;;;;GAOG;AACH,MAAM,MAAM,iBAAiB,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC"}

package/packages/agent/src/runtime/plugin-lifecycle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin-lifecycle.d.ts","sourceRoot":"","sources":["../../../../../src/runtime/plugin-lifecycle.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,MAAM,EACN,YAAY,EACZ,SAAS,EACT,MAAM,EACN,uBAAuB,EACvB,QAAQ,EACR,KAAK,EAEL,YAAY,EACZ,eAAe,EAChB,MAAM,eAAe,CAAC;AAMvB,sFAAsF;AACtF,KAAK,oBAAoB,GAAG;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,MAAM,EAAE,4BAA4B,EAAE,CAAC;IACvC,MAAM,EAAE,4BAA4B,EAAE,CAAC;IACvC,QAAQ,EAAE,8BAA8B,EAAE,CAAC;IAC3C,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,UAAU,EAAE,OAAO,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,KAAK,4BAA4B,GAAG;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7C,CAAC;AAEF,KAAK,4BAA4B,GAAG;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,uBAAuB,CAAC,SAAS,CAAC,CAAC;IAC5C,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,KAAK,8BAA8B,GAAG;IACpC,WAAW,EAAE,eAAe,CAAC;IAC7B,YAAY,EAAE,YAAY,CAAC;CAC5B,CAAC;AA8DF,MAAM,MAAM,sBAAsB,GAAG,oBAAoB,CAAC;AAE1D,KAAK,0BAA0B,GAAG,YAAY,GAAG;IAC/C,+BAA+B,CAAC,EAAE,OAAO,CAAC;IAC1C,sBAAsB,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC;IAC7D,YAAY,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,sBAAsB,GAAG,IAAI,CAAC,CAAC;IAC9E,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD,iBAAiB,CAAC,EAAE,CAClB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAC3B,OAAO,CAAC,OAAO,CAAC,CAAC;IACtB,kBAAkB,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,sBAAsB,GAAG,IAAI,CAAC;IAC3E,qBAAqB,CAAC,EAAE,MAAM,sBAAsB,EAAE,CAAC;CACxD,CAAC;AAueF,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,CAuSzE;AAED,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,YAAY,GAAG,IAAI,GAC3B,OAAO,IAAI,0BAA0B,CAUvC"}
+{"version":3,"file":"plugin-lifecycle.d.ts","sourceRoot":"","sources":["../../../../../src/runtime/plugin-lifecycle.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,MAAM,EACN,YAAY,EACZ,SAAS,EACT,MAAM,EACN,uBAAuB,EACvB,QAAQ,EACR,KAAK,EAEL,YAAY,EACZ,eAAe,EAChB,MAAM,eAAe,CAAC;AAMvB,sFAAsF;AACtF,KAAK,oBAAoB,GAAG;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,MAAM,EAAE,4BAA4B,EAAE,CAAC;IACvC,MAAM,EAAE,4BAA4B,EAAE,CAAC;IACvC,QAAQ,EAAE,8BAA8B,EAAE,CAAC;IAC3C,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,UAAU,EAAE,OAAO,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,KAAK,4BAA4B,GAAG;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7C,CAAC;AAEF,KAAK,4BAA4B,GAAG;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,uBAAuB,CAAC,SAAS,CAAC,CAAC;IAC5C,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,KAAK,8BAA8B,GAAG;IACpC,WAAW,EAAE,eAAe,CAAC;IAC7B,YAAY,EAAE,YAAY,CAAC;CAC5B,CAAC;AA8DF,MAAM,MAAM,sBAAsB,GAAG,oBAAoB,CAAC;AAE1D,KAAK,0BAA0B,GAAG,YAAY,GAAG;IAC/C,+BAA+B,CAAC,EAAE,OAAO,CAAC;IAC1C,sBAAsB,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC;IAC7D,YAAY,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,sBAAsB,GAAG,IAAI,CAAC,CAAC;IAC9E,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD,iBAAiB,CAAC,EAAE,CAClB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAC3B,OAAO,CAAC,OAAO,CAAC,CAAC;IACtB,kBAAkB,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,sBAAsB,GAAG,IAAI,CAAC;IAC3E,qBAAqB,CAAC,EAAE,MAAM,sBAAsB,EAAE,CAAC;CACxD,CAAC;AA+eF,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,CAuSzE;AAED,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,YAAY,GAAG,IAAI,GAC3B,OAAO,IAAI,0BAA0B,CAUvC"}

package/packages/agent/src/runtime/plugin-lifecycle.js

@@ -49,7 +49,9 @@ function applyEffectiveActionContexts(action, pluginContexts) {
     }
     return {
         ...inherited,
-        contexts: [...resolveActionContexts(inherited)],
+        contexts: [
+            ...resolveActionContexts(inherited),
+        ],
     };
 }
 function applyEffectiveProviderContexts(provider, pluginContexts) {
@@ -59,7 +61,9 @@ function applyEffectiveProviderContexts(provider, pluginContexts) {
     }
     return {
         ...inherited,
-        contexts: [...resolveProviderContexts(inherited)],
+        contexts: [
+            ...resolveProviderContexts(inherited),
+        ],
     };
 }
 function pushUniqueEvent(items, next) {

package/packages/agent/src/runtime/plugin-resolver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin-resolver.d.ts","sourceRoot":"","sources":["../../../../../src/runtime/plugin-resolver.ts"],"names":[],"mappings":"AAoBA,OAAO,EAAE,KAAK,WAAW,EAAmB,MAAM,qBAAqB,CAAC;AAgBxE,OAAO,EAML,KAAK,iBAAiB,EACtB,KAAK,cAAc,EAOpB,MAAM,mBAAmB,CAAC;AAyL3B;;;;;;;;;;GAUG;AACH,wBAAsB,0BAA0B,CAC9C,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,iBAAiB,CAAC,CAkC5B;AAgCD,wBAAgB,wBAAwB,IAAI,MAAM,EAAE,CAMnD;AAkVD;;;;;;;;;;;GAWG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,WAAW,EACnB,IAAI,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GACzB,OAAO,CAAC,cAAc,EAAE,CAAC,CAsZ3B"}
+{"version":3,"file":"plugin-resolver.d.ts","sourceRoot":"","sources":["../../../../../src/runtime/plugin-resolver.ts"],"names":[],"mappings":"AAoBA,OAAO,EAAE,KAAK,WAAW,EAAmB,MAAM,qBAAqB,CAAC;AAgBxE,OAAO,EAML,KAAK,iBAAiB,EACtB,KAAK,cAAc,EAOpB,MAAM,mBAAmB,CAAC;AAyL3B;;;;;;;;;;GAUG;AACH,wBAAsB,0BAA0B,CAC9C,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,iBAAiB,CAAC,CAkC5B;AAgCD,wBAAgB,wBAAwB,IAAI,MAAM,EAAE,CAMnD;AAkVD;;;;;;;;;;;GAWG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,WAAW,EACnB,IAAI,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GACzB,OAAO,CAAC,cAAc,EAAE,CAAC,CAqZ3B"}

package/packages/agent/src/runtime/plugin-resolver.js

@@ -693,13 +693,12 @@ export async function resolvePlugins(config, opts) {
                 mod = await importOfficialPluginFromNodeModules();
             }
             else {
-                // Built-in/npm plugin — try bundled static import first, then
-                // fall back to bare node_modules resolution.
-                const staticMod = isOfficialElizaPlugin
-                    ? await resolveStaticElizaPlugin(pluginName)
-                    : null;
-                mod = staticMod
-                    ? staticMod
+                // Built-in/npm plugin — prefer a bundled static import regardless of
+                // naming convention (short-name plugins like "agent-orchestrator" are
+                // registered in STATIC_ELIZA_PLUGINS and would otherwise fail a bare
+                // node_modules resolution).
+                mod = staticElizaPlugin
+                    ? staticElizaPlugin
                     : (await import(__rewriteRelativeImportExtension(pluginName)));
             }
             const pluginInstance = findRuntimePluginExport(mod);

package/packages/agent/src/runtime/plugin-types.d.ts

@@ -1,5 +1,4 @@
 import { type Plugin } from "@elizaos/core";
-import type { ElizaConfig } from "../config/config.js";
 import type { PluginInstallRecord } from "../config/types.eliza.js";
 /** A successfully resolved plugin ready for AgentRuntime registration. */
 export interface ResolvedPlugin {
@@ -63,9 +62,4 @@ export declare function findPluginBrowserStagehandDir(startDir: string): string
  * @returns `true` when `dist/server` already resolves or symlink succeeded.
  */
 export declare function ensureBrowserServerLink(): boolean;
-/** @internal Exported for testing. */
-export declare function repairBrokenInstallRecord(config: ElizaConfig, pluginName: string): boolean;
-/** Read package.json exports/main to find the importable entry file. */
-/** @internal Exported for testing. */
-export declare function resolvePackageEntry(pkgRoot: string): Promise<string>;
 //# sourceMappingURL=plugin-types.d.ts.map

package/packages/agent/src/runtime/plugin-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin-types.d.ts","sourceRoot":"","sources":["../../../../../src/runtime/plugin-types.ts"],"names":[],"mappings":"AAeA,OAAO,EAAU,KAAK,MAAM,EAAE,MAAM,eAAe,CAAC;AAEpD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAMpE,0EAA0E;AAC1E,MAAM,WAAW,cAAc;IAC7B,2DAA2D;IAC3D,IAAI,EAAE,MAAM,CAAC;IACb,qDAAqD;IACrD,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,kEAAkE;AAClE,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;CACnC;AAMD;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,CAAC;AAEhE,yEAAyE;AACzE,eAAO,MAAM,sBAAsB,mBAAmB,CAAC;AACvD,kEAAkE;AAClE,eAAO,MAAM,uBAAuB,oBAAoB,CAAC;AAyCzD,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,iBAAiB,GAAG,MAAM,GAAG,IAAI,CAsC7E;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC,CA2C9C;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE;IACzC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;IACnD,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;IACpD,eAAe,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACrC,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC9B,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CAC5B,GAAG;IAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAyB5C;AAED,wBAAgB,iCAAiC,CAC/C,UAAU,EAAE,MAAM,EAClB,gBAAgB,SAAkB,GACjC,MAAM,CAaR;AAED,wBAAgB,+BAA+B,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAE3E;AAED,wBAAgB,6BAA6B,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAmB7E;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,uBAAuB,IAAI,OAAO,CAyEjD;AAED,sCAAsC;AACtC,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,WAAW,EACnB,UAAU,EAAE,MAAM,GACjB,OAAO,CAST;AAED,wEAAwE;AACxE,sCAAsC;AACtC,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA8D1E"}
+{"version":3,"file":"plugin-types.d.ts","sourceRoot":"","sources":["../../../../../src/runtime/plugin-types.ts"],"names":[],"mappings":"AAeA,OAAO,EAAU,KAAK,MAAM,EAAE,MAAM,eAAe,CAAC;AAGpD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAMpE,0EAA0E;AAC1E,MAAM,WAAW,cAAc;IAC7B,2DAA2D;IAC3D,IAAI,EAAE,MAAM,CAAC;IACb,qDAAqD;IACrD,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,kEAAkE;AAClE,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;CACnC;AAMD;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,CAAC;AAEhE,yEAAyE;AACzE,eAAO,MAAM,sBAAsB,mBAAmB,CAAC;AACvD,kEAAkE;AAClE,eAAO,MAAM,uBAAuB,oBAAoB,CAAC;AAyCzD,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,iBAAiB,GAAG,MAAM,GAAG,IAAI,CAsC7E;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC,CA2C9C;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE;IACzC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;IACnD,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;IACpD,eAAe,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACrC,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC9B,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CAC5B,GAAG;IAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAyB5C;AAED,wBAAgB,iCAAiC,CAC/C,UAAU,EAAE,MAAM,EAClB,gBAAgB,SAAkB,GACjC,MAAM,CAaR;AAED,wBAAgB,+BAA+B,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAE3E;AAED,wBAAgB,6BAA6B,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAmB7E;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,uBAAuB,IAAI,OAAO,CAyEjD"}

package/packages/agent/src/runtime/roles/src/utils.d.ts

@@ -1,2 +1,2 @@
-export * from "@elizaos/core";
+export { canModifyRole, checkSenderPrivateAccess, checkSenderRole, getConfiguredOwnerEntityIds, getConnectorAdminWhitelist, getEntityRole, getLiveEntityMetadataFromMessage, hasConfiguredCanonicalOwner, matchEntityToConnectorAdminWhitelist, normalizeRole, resolveCanonicalOwnerId, resolveCanonicalOwnerIdForMessage, resolveEntityRole, resolveWorldForMessage, setConnectorAdminWhitelist, setEntityRole, } from "@elizaos/core";
 //# sourceMappingURL=utils.d.ts.map

package/packages/agent/src/runtime/roles/src/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../../../../src/runtime/roles/src/utils.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../../../../src/runtime/roles/src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,wBAAwB,EACxB,eAAe,EACf,2BAA2B,EAC3B,0BAA0B,EAC1B,aAAa,EACb,gCAAgC,EAChC,2BAA2B,EAC3B,oCAAoC,EACpC,aAAa,EACb,uBAAuB,EACvB,iCAAiC,EACjC,iBAAiB,EACjB,sBAAsB,EACtB,0BAA0B,EAC1B,aAAa,GACd,MAAM,eAAe,CAAC"}

package/packages/agent/src/runtime/roles/src/utils.js

@@ -1 +1 @@
-export * from "@elizaos/core";
+export { canModifyRole, checkSenderPrivateAccess, checkSenderRole, getConfiguredOwnerEntityIds, getConnectorAdminWhitelist, getEntityRole, getLiveEntityMetadataFromMessage, hasConfiguredCanonicalOwner, matchEntityToConnectorAdminWhitelist, normalizeRole, resolveCanonicalOwnerId, resolveCanonicalOwnerIdForMessage, resolveEntityRole, resolveWorldForMessage, setConnectorAdminWhitelist, setEntityRole, } from "@elizaos/core";

package/packages/agent/src/runtime/subagent-output.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Subagent output helpers for delivering final task output to the originating
+ * chat channel.
+ *
+ * The swarm synthesis path uses `completionSummary` (a short LLM-generated
+ * description of what the agent did). For user-facing replies we want the
+ * subagent's actual answer — the last `stop_reason: end_turn` assistant
+ * message from the Claude Code session jsonl. This module reads that and
+ * provides Discord-safe chunking.
+ *
+ * Path encoding mirrors Claude Code: `/home/milady/.milady/workspaces/abc`
+ * becomes `-home-milady--milady-workspaces-abc` (every `/` and `.` maps to
+ * `-`; the sequence `/.` produces `--`).
+ *
+ * @module runtime/subagent-output
+ */
+/**
+ * Read the latest `stop_reason: end_turn` assistant text from the Claude Code
+ * session jsonl under a subagent's workdir. Returns null when no such line
+ * exists yet (still running, crashed before responding, or wrong workdir).
+ */
+export declare function readLastAssistantTextFromJsonl(workdir: string): Promise<string | null>;
+/**
+ * Locate the newest `.jsonl` file under Claude Code's project directory for
+ * the given workdir.
+ */
+export declare function findLatestJsonl(workdir: string): Promise<string | null>;
+/**
+ * Scan jsonl text tail-first for the latest assistant message with
+ * `stop_reason: end_turn` and return its text. Walks past any trailing
+ * `tool_use` turns (the coordinator's "respond" follow-up can trigger
+ * another tool round after the real answer, leaving a tool_use line
+ * as the tail). Skips synthetic retry shims and Anthropic api_error
+ * frames (529/overload) so transient retries never surface as the
+ * agent's answer.
+ */
+export declare function findLatestEndTurnText(content: string): string | null;
+/**
+ * Scan jsonl tail-first for the most recent subagent activity worth showing
+ * the user in a heartbeat — the name of the most recent `tool_use` call,
+ * falling back to the leading text of the latest assistant block. Returns
+ * null if the jsonl has no assistant/tool activity yet.
+ */
+export declare function readCurrentActivityFromJsonl(workdir: string): Promise<string | null>;
+/**
+ * Split text into Discord-safe chunks (≤ max chars each), preferring
+ * paragraph → line → word boundaries past the halfway mark. Callers should
+ * pass 1900 to leave headroom under Discord's 2000-char per-message limit.
+ */
+export declare function chunkForDiscord(text: string, max: number): string[];
+//# sourceMappingURL=subagent-output.d.ts.map

package/packages/agent/src/runtime/subagent-output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagent-output.d.ts","sourceRoot":"","sources":["../../../../../src/runtime/subagent-output.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AA4BH;;;;GAIG;AACH,wBAAsB,8BAA8B,CAClD,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAGxB;AAED;;;GAGG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAmB7E;AAYD;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAqBpE;AAED;;;;;GAKG;AACH,wBAAsB,4BAA4B,CAChD,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAwBxB;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAenE"}

package/packages/agent/src/runtime/subagent-output.js

@@ -0,0 +1,173 @@
+/**
+ * Subagent output helpers for delivering final task output to the originating
+ * chat channel.
+ *
+ * The swarm synthesis path uses `completionSummary` (a short LLM-generated
+ * description of what the agent did). For user-facing replies we want the
+ * subagent's actual answer — the last `stop_reason: end_turn` assistant
+ * message from the Claude Code session jsonl. This module reads that and
+ * provides Discord-safe chunking.
+ *
+ * Path encoding mirrors Claude Code: `/home/milady/.milady/workspaces/abc`
+ * becomes `-home-milady--milady-workspaces-abc` (every `/` and `.` maps to
+ * `-`; the sequence `/.` produces `--`).
+ *
+ * @module runtime/subagent-output
+ */
+import { promises as fs } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+function parseJsonlLine(line) {
+    try {
+        return JSON.parse(line);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Read the latest `stop_reason: end_turn` assistant text from the Claude Code
+ * session jsonl under a subagent's workdir. Returns null when no such line
+ * exists yet (still running, crashed before responding, or wrong workdir).
+ */
+export async function readLastAssistantTextFromJsonl(workdir) {
+    const content = await readJsonl(workdir);
+    return content === null ? null : findLatestEndTurnText(content);
+}
+/**
+ * Locate the newest `.jsonl` file under Claude Code's project directory for
+ * the given workdir.
+ */
+export async function findLatestJsonl(workdir) {
+    const projectKey = workdir.replace(/[/.]/g, "-");
+    const projectDir = join(homedir(), ".claude", "projects", projectKey);
+    let entries;
+    try {
+        entries = await fs.readdir(projectDir);
+    }
+    catch {
+        return null;
+    }
+    const jsonls = entries.filter((f) => f.endsWith(".jsonl"));
+    if (jsonls.length === 0)
+        return null;
+    const withMtime = await Promise.all(jsonls.map(async (f) => {
+        const s = await fs.stat(join(projectDir, f));
+        return { f, mtime: s.mtimeMs };
+    }));
+    withMtime.sort((a, b) => b.mtime - a.mtime);
+    return join(projectDir, withMtime[0].f);
+}
+async function readJsonl(workdir) {
+    const jsonlPath = await findLatestJsonl(workdir);
+    if (!jsonlPath)
+        return null;
+    try {
+        return await fs.readFile(jsonlPath, "utf-8");
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Scan jsonl text tail-first for the latest assistant message with
+ * `stop_reason: end_turn` and return its text. Walks past any trailing
+ * `tool_use` turns (the coordinator's "respond" follow-up can trigger
+ * another tool round after the real answer, leaving a tool_use line
+ * as the tail). Skips synthetic retry shims and Anthropic api_error
+ * frames (529/overload) so transient retries never surface as the
+ * agent's answer.
+ */
+export function findLatestEndTurnText(content) {
+    const lines = content.split("\n");
+    for (let i = lines.length - 1; i >= 0; i--) {
+        const line = lines[i].trim();
+        if (!line)
+            continue;
+        const parsed = parseJsonlLine(line);
+        if (!parsed)
+            continue;
+        if (parsed.subtype === "api_error" || parsed.isApiErrorMessage)
+            continue;
+        const msg = parsed.message;
+        if (!msg || msg.role !== "assistant")
+            continue;
+        if (msg.model === "<synthetic>")
+            continue;
+        if (msg.stop_reason !== "end_turn")
+            continue;
+        const textParts = [];
+        for (const c of msg.content ?? []) {
+            if (c.type === "text" && typeof c.text === "string" && c.text.trim()) {
+                textParts.push(c.text.trim());
+            }
+        }
+        if (textParts.length > 0)
+            return textParts.join("\n\n");
+    }
+    return null;
+}
+/**
+ * Scan jsonl tail-first for the most recent subagent activity worth showing
+ * the user in a heartbeat — the name of the most recent `tool_use` call,
+ * falling back to the leading text of the latest assistant block. Returns
+ * null if the jsonl has no assistant/tool activity yet.
+ */
+export async function readCurrentActivityFromJsonl(workdir) {
+    const content = await readJsonl(workdir);
+    if (content === null)
+        return null;
+    const lines = content.split("\n");
+    for (let i = lines.length - 1; i >= 0; i--) {
+        const line = lines[i].trim();
+        if (!line)
+            continue;
+        const parsed = parseJsonlLine(line);
+        if (!parsed)
+            continue;
+        if (parsed.subtype === "api_error" || parsed.isApiErrorMessage)
+            continue;
+        const msg = parsed.message;
+        if (!msg || msg.role !== "assistant")
+            continue;
+        if (msg.model === "<synthetic>")
+            continue;
+        for (const c of msg.content ?? []) {
+            if (c.type === "tool_use" && typeof c.name === "string")
+                return c.name;
+        }
+        for (const c of msg.content ?? []) {
+            if (c.type === "text" && typeof c.text === "string" && c.text.trim()) {
+                const first = c.text.trim().split("\n")[0] ?? "";
+                return first.length > 80 ? `${first.slice(0, 77)}…` : first;
+            }
+        }
+    }
+    return null;
+}
+/**
+ * Split text into Discord-safe chunks (≤ max chars each), preferring
+ * paragraph → line → word boundaries past the halfway mark. Callers should
+ * pass 1900 to leave headroom under Discord's 2000-char per-message limit.
+ */
+export function chunkForDiscord(text, max) {
+    if (text.length <= max)
+        return [text];
+    const out = [];
+    let remaining = text;
+    while (remaining.length > max) {
+        const half = Math.floor(max / 2);
+        let cut = remaining.lastIndexOf("\n\n", max);
+        if (cut < half)
+            cut = remaining.lastIndexOf("\n", max);
+        if (cut < half)
+            cut = remaining.lastIndexOf(" ", max);
+        if (cut < half)
+            cut = max;
+        out.push(remaining.slice(0, cut).trimEnd());
+        remaining = remaining.slice(cut).trimStart();
+    }
+    if (remaining)
+        out.push(remaining);
+    return out;
+}

package/packages/agent/src/runtime/task-heartbeat.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Task heartbeat — one "still working" chat ping per originating room per
+ * {@link HEARTBEAT_MIN_INTERVAL_MS}, for any PTY session that's been
+ * running past {@link HEARTBEAT_AFTER_MS}.
+ *
+ * Rate-limited by roomId (not by sessionId) because a swarm can spawn
+ * multiple sessions for a single user prompt and the user sees that as
+ * one task; firing one heartbeat per session would read as spam.
+ *
+ * Silent for autonomous sessions (no originating roomId) so background
+ * coordinator work doesn't spam chat.
+ *
+ * @module runtime/task-heartbeat
+ */
+import type { IAgentRuntime } from "@elizaos/core";
+/**
+ * Install the heartbeat on a PTY service. Returns a disposer that
+ * unsubscribes the listener. No-op when the service does not expose the
+ * event API (tests, mocks).
+ */
+export declare function installTaskHeartbeat(runtime: IAgentRuntime, ptyService: unknown): () => void;
+//# sourceMappingURL=task-heartbeat.d.ts.map

package/packages/agent/src/runtime/task-heartbeat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-heartbeat.d.ts","sourceRoot":"","sources":["../../../../../src/runtime/task-heartbeat.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAQ,MAAM,eAAe,CAAC;AA8BzD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,aAAa,EACtB,UAAU,EAAE,OAAO,GAClB,MAAM,IAAI,CAoEZ"}

package/packages/agent/src/runtime/task-heartbeat.js

@@ -0,0 +1,84 @@
+/**
+ * Task heartbeat — one "still working" chat ping per originating room per
+ * {@link HEARTBEAT_MIN_INTERVAL_MS}, for any PTY session that's been
+ * running past {@link HEARTBEAT_AFTER_MS}.
+ *
+ * Rate-limited by roomId (not by sessionId) because a swarm can spawn
+ * multiple sessions for a single user prompt and the user sees that as
+ * one task; firing one heartbeat per session would read as spam.
+ *
+ * Silent for autonomous sessions (no originating roomId) so background
+ * coordinator work doesn't spam chat.
+ *
+ * @module runtime/task-heartbeat
+ */
+import { logger } from "@elizaos/core";
+import { readCurrentActivityFromJsonl } from "./subagent-output.js";
+/** Time before the first heartbeat fires for a freshly-spawned session. */
+const HEARTBEAT_AFTER_MS = 45_000;
+/** Minimum gap between heartbeat messages posted to the same room. */
+const HEARTBEAT_MIN_INTERVAL_MS = 120_000;
+/**
+ * Install the heartbeat on a PTY service. Returns a disposer that
+ * unsubscribes the listener. No-op when the service does not expose the
+ * event API (tests, mocks).
+ */
+export function installTaskHeartbeat(runtime, ptyService) {
+    const svc = ptyService;
+    if (!svc || typeof svc.onSessionEvent !== "function") {
+        return () => { };
+    }
+    const sessions = new Map();
+    // Global rate limit: one heartbeat per room per HEARTBEAT_MIN_INTERVAL_MS.
+    // A single user prompt can spawn multiple sessions; treating each as its
+    // own heartbeat target reads as spam.
+    const lastPostedAtByRoom = new Map();
+    const fire = async (sessionId) => {
+        const state = sessions.get(sessionId);
+        if (!state)
+            return;
+        sessions.delete(sessionId);
+        const meta = svc.sessionMetadata?.get(sessionId);
+        const roomId = typeof meta?.roomId === "string" ? meta.roomId : null;
+        if (!roomId)
+            return;
+        const now = Date.now();
+        const lastPosted = lastPostedAtByRoom.get(roomId) ?? 0;
+        if (now - lastPosted < HEARTBEAT_MIN_INTERVAL_MS)
+            return;
+        lastPostedAtByRoom.set(roomId, now);
+        const room = await runtime
+            .getRoom(roomId)
+            .catch(() => null);
+        if (!room?.channelId || !room.source)
+            return;
+        const workdir = svc.getSession?.(sessionId)?.workdir;
+        const activity = workdir
+            ? await readCurrentActivityFromJsonl(workdir).catch(() => null)
+            : null;
+        const seconds = Math.round((now - state.startedAt) / 1000);
+        const text = activity
+            ? `still working — ${seconds}s in (${activity})`
+            : `still working — ${seconds}s in`;
+        await runtime.sendMessageToTarget({ source: room.source, roomId, channelId: room.channelId }, { text, source: "task-heartbeat" });
+    };
+    return svc.onSessionEvent((sessionId, event) => {
+        if (event === "stopped" || event === "task_complete" || event === "error") {
+            const state = sessions.get(sessionId);
+            if (state)
+                clearTimeout(state.timer);
+            sessions.delete(sessionId);
+            return;
+        }
+        if (sessions.has(sessionId))
+            return;
+        sessions.set(sessionId, {
+            startedAt: Date.now(),
+            timer: setTimeout(() => {
+                void fire(sessionId).catch((err) => {
+                    logger.debug(`[task-heartbeat] fire failed for ${sessionId}: ${err instanceof Error ? err.message : String(err)}`);
+                });
+            }, HEARTBEAT_AFTER_MS),
+        });
+    });
+}