@elizaos/shared 2.0.0-alpha.144

package/contracts/wallet.js

@@ -0,0 +1,61 @@
+/**
+ * Shared wallet API contracts.
+ */
+export const WALLET_RPC_PROVIDER_OPTIONS = {
+    evm: [
+        { id: "eliza-cloud", label: "Eliza Cloud" },
+        { id: "alchemy", label: "Alchemy" },
+        { id: "infura", label: "Infura" },
+        { id: "ankr", label: "Ankr" },
+    ],
+    bsc: [
+        { id: "eliza-cloud", label: "Eliza Cloud" },
+        { id: "alchemy", label: "Alchemy" },
+        { id: "ankr", label: "Ankr" },
+        { id: "nodereal", label: "NodeReal" },
+        { id: "quicknode", label: "QuickNode" },
+    ],
+    solana: [
+        { id: "eliza-cloud", label: "Eliza Cloud" },
+        { id: "helius-birdeye", label: "Helius + Birdeye" },
+    ],
+};
+export const DEFAULT_WALLET_RPC_SELECTIONS = {
+    evm: "eliza-cloud",
+    bsc: "eliza-cloud",
+    solana: "eliza-cloud",
+};
+const WALLET_RPC_PROVIDER_ALIASES = {
+    elizacloud: "eliza-cloud",
+    helius: "helius-birdeye",
+};
+const WALLET_RPC_PROVIDER_IDS = {
+    evm: new Set(WALLET_RPC_PROVIDER_OPTIONS.evm.map((option) => option.id)),
+    bsc: new Set(WALLET_RPC_PROVIDER_OPTIONS.bsc.map((option) => option.id)),
+    solana: new Set(WALLET_RPC_PROVIDER_OPTIONS.solana.map((option) => option.id)),
+};
+export function normalizeWalletRpcProviderId(chain, value) {
+    if (typeof value !== "string")
+        return null;
+    const trimmed = value.trim().toLowerCase();
+    if (!trimmed)
+        return null;
+    const normalized = WALLET_RPC_PROVIDER_ALIASES[trimmed]
+        ? WALLET_RPC_PROVIDER_ALIASES[trimmed]
+        : trimmed;
+    if (WALLET_RPC_PROVIDER_IDS[chain].has(normalized)) {
+        return normalized;
+    }
+    return null;
+}
+export function normalizeWalletRpcSelections(input) {
+    return {
+        evm: normalizeWalletRpcProviderId("evm", input?.evm) ??
+            DEFAULT_WALLET_RPC_SELECTIONS.evm,
+        bsc: normalizeWalletRpcProviderId("bsc", input?.bsc) ??
+            DEFAULT_WALLET_RPC_SELECTIONS.bsc,
+        solana: normalizeWalletRpcProviderId("solana", input?.solana) ??
+            DEFAULT_WALLET_RPC_SELECTIONS.solana,
+    };
+}
+//# sourceMappingURL=wallet.js.map

package/contracts/wallet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wallet.js","sourceRoot":"","sources":["../../src/contracts/wallet.ts"],"names":[],"mappings":"AAAA;;GAEG;AA6EH,MAAM,CAAC,MAAM,2BAA2B,GAAG;IACzC,GAAG,EAAE;QACH,EAAE,EAAE,EAAE,aAAa,EAAE,KAAK,EAAE,aAAa,EAAE;QAC3C,EAAE,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE;QACnC,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE;QACjC,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE;KAC9B;IACD,GAAG,EAAE;QACH,EAAE,EAAE,EAAE,aAAa,EAAE,KAAK,EAAE,aAAa,EAAE;QAC3C,EAAE,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE;QACnC,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE;QAC7B,EAAE,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE;QACrC,EAAE,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,WAAW,EAAE;KACxC;IACD,MAAM,EAAE;QACN,EAAE,EAAE,EAAE,aAAa,EAAE,KAAK,EAAE,aAAa,EAAE;QAC3C,EAAE,EAAE,EAAE,gBAAgB,EAAE,KAAK,EAAE,kBAAkB,EAAE;KACpD;CACO,CAAC;AAgBX,MAAM,CAAC,MAAM,6BAA6B,GAAwB;IAChE,GAAG,EAAE,aAAa;IAClB,GAAG,EAAE,aAAa;IAClB,MAAM,EAAE,aAAa;CACtB,CAAC;AAEF,MAAM,2BAA2B,GAAG;IAClC,UAAU,EAAE,aAAa;IACzB,MAAM,EAAE,gBAAgB;CAChB,CAAC;AAEX,MAAM,uBAAuB,GAAG;IAC9B,GAAG,EAAE,IAAI,GAAG,CAAC,2BAA2B,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACxE,GAAG,EAAE,IAAI,GAAG,CAAC,2BAA2B,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACxE,MAAM,EAAE,IAAI,GAAG,CACb,2BAA2B,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAC9D;CACO,CAAC;AAEX,MAAM,UAAU,4BAA4B,CAC1C,KAAa,EACb,KAAgC;IAEhC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC3C,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC3C,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAC1B,MAAM,UAAU,GAAG,2BAA2B,CAC5C,OAAmD,CACpD;QACC,CAAC,CAAC,2BAA2B,CACzB,OAAmD,CACpD;QACH,CAAC,CAAC,OAAO,CAAC;IACZ,IAAK,uBAAuB,CAAC,KAAK,CAAyB,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;QAC5E,OAAO,UAAyC,CAAC;IACnD,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,4BAA4B,CAC1C,KAIa;IAEb,OAAO;QACL,GAAG,EACD,4BAA4B,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,CAAC;YAC/C,6BAA6B,CAAC,GAAG;QACnC,GAAG,EACD,4BAA4B,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,CAAC;YAC/C,6BAA6B,CAAC,GAAG;QACnC,MAAM,EACJ,4BAA4B,CAAC,QAAQ,EAAE,KAAK,EAAE,MAAM,CAAC;YACrD,6BAA6B,CAAC,MAAM;KACvC,CAAC;AACJ,CAAC"}

package/dev-settings-banner-style.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Optional ANSI styling for dev settings banners (orchestrator, Vite, API, Electrobun).
+ * Plain tables live in `dev-settings-table.ts`; this only wraps box lines for terminals.
+ * Figlet headings use a separate color; use `colorizeDevSettingsStartupBanner` when a
+ * heading is prepended above the framed table.
+ */
+/** Add cyan emphasis to Unicode box lines; no-op when not a TTY or when `NO_COLOR` is set. */
+export declare function colorizeDevSettingsBanner(text: string): string;
+/**
+ * Colorize a block that may start with a figlet heading, then a framed table (and optional
+ * plain footer after the box). Figlet lines are magenta; box lines stay cyan.
+ */
+export declare function colorizeDevSettingsStartupBanner(text: string): string;
+//# sourceMappingURL=dev-settings-banner-style.d.ts.map

package/dev-settings-banner-style.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-settings-banner-style.d.ts","sourceRoot":"","sources":["../src/dev-settings-banner-style.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA4BH,8FAA8F;AAC9F,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAG9D;AAED;;;GAGG;AACH,wBAAgB,gCAAgC,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQrE"}

package/dev-settings-banner-style.js

@@ -0,0 +1,58 @@
+/**
+ * Optional ANSI styling for dev settings banners (orchestrator, Vite, API, Electrobun).
+ * Plain tables live in `dev-settings-table.ts`; this only wraps box lines for terminals.
+ * Figlet headings use a separate color; use `colorizeDevSettingsStartupBanner` when a
+ * heading is prepended above the framed table.
+ */
+const RESET = "\x1b[0m";
+const BOLD_CYAN = "\x1b[1;36m";
+const DIM_CYAN = "\x1b[2;36m";
+const BOLD_MAGENTA = "\x1b[1;35m";
+function shouldSkipBannerColor() {
+    if (typeof process === "undefined" || !process.env)
+        return true;
+    if ("NO_COLOR" in process.env)
+        return true;
+    const fc = process.env.FORCE_COLOR;
+    if (fc === "0" || fc === "false")
+        return true;
+    if (fc === "1" || fc === "true")
+        return false;
+    if (typeof process.stdout?.isTTY === "boolean" && !process.stdout.isTTY)
+        return true;
+    return false;
+}
+function colorizeDevSettingsBannerLine(line) {
+    if (line.length === 0)
+        return line;
+    const c0 = line.codePointAt(0);
+    if (c0 === 0x256d /* ╭ */ || c0 === 0x2570 /* ╰ */)
+        return `${BOLD_CYAN}${line}${RESET}`;
+    if (c0 === 0x251c /* ├ */)
+        return `${DIM_CYAN}${line}${RESET}`;
+    if (c0 === 0x2502 /* │ */)
+        return `${DIM_CYAN}${line}${RESET}`;
+    return line;
+}
+/** Add cyan emphasis to Unicode box lines; no-op when not a TTY or when `NO_COLOR` is set. */
+export function colorizeDevSettingsBanner(text) {
+    if (shouldSkipBannerColor())
+        return text;
+    return text.split("\n").map(colorizeDevSettingsBannerLine).join("\n");
+}
+/**
+ * Colorize a block that may start with a figlet heading, then a framed table (and optional
+ * plain footer after the box). Figlet lines are magenta; box lines stay cyan.
+ */
+export function colorizeDevSettingsStartupBanner(text) {
+    if (shouldSkipBannerColor())
+        return text;
+    const idx = text.indexOf("╭");
+    if (idx === -1)
+        return colorizeDevSettingsBanner(text);
+    const head = text.slice(0, idx).replace(/\n+$/u, "");
+    const tail = text.slice(idx);
+    const coloredHead = head ? `${BOLD_MAGENTA}${head}${RESET}\n` : "";
+    return coloredHead + colorizeDevSettingsBanner(tail);
+}
+//# sourceMappingURL=dev-settings-banner-style.js.map

package/dev-settings-banner-style.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-settings-banner-style.js","sourceRoot":"","sources":["../src/dev-settings-banner-style.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,KAAK,GAAG,SAAS,CAAC;AACxB,MAAM,SAAS,GAAG,YAAY,CAAC;AAC/B,MAAM,QAAQ,GAAG,YAAY,CAAC;AAC9B,MAAM,YAAY,GAAG,YAAY,CAAC;AAElC,SAAS,qBAAqB;IAC5B,IAAI,OAAO,OAAO,KAAK,WAAW,IAAI,CAAC,OAAO,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IAChE,IAAI,UAAU,IAAI,OAAO,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IAC3C,MAAM,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC;IACnC,IAAI,EAAE,KAAK,GAAG,IAAI,EAAE,KAAK,OAAO;QAAE,OAAO,IAAI,CAAC;IAC9C,IAAI,EAAE,KAAK,GAAG,IAAI,EAAE,KAAK,MAAM;QAAE,OAAO,KAAK,CAAC;IAC9C,IAAI,OAAO,OAAO,CAAC,MAAM,EAAE,KAAK,KAAK,SAAS,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK;QACrE,OAAO,IAAI,CAAC;IACd,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,6BAA6B,CAAC,IAAY;IACjD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACnC,MAAM,EAAE,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IAC/B,IAAI,EAAE,KAAK,MAAM,CAAC,OAAO,IAAI,EAAE,KAAK,MAAM,CAAC,OAAO;QAChD,OAAO,GAAG,SAAS,GAAG,IAAI,GAAG,KAAK,EAAE,CAAC;IACvC,IAAI,EAAE,KAAK,MAAM,CAAC,OAAO;QAAE,OAAO,GAAG,QAAQ,GAAG,IAAI,GAAG,KAAK,EAAE,CAAC;IAC/D,IAAI,EAAE,KAAK,MAAM,CAAC,OAAO;QAAE,OAAO,GAAG,QAAQ,GAAG,IAAI,GAAG,KAAK,EAAE,CAAC;IAC/D,OAAO,IAAI,CAAC;AACd,CAAC;AAED,8FAA8F;AAC9F,MAAM,UAAU,yBAAyB,CAAC,IAAY;IACpD,IAAI,qBAAqB,EAAE;QAAE,OAAO,IAAI,CAAC;IACzC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACxE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gCAAgC,CAAC,IAAY;IAC3D,IAAI,qBAAqB,EAAE;QAAE,OAAO,IAAI,CAAC;IACzC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC9B,IAAI,GAAG,KAAK,CAAC,CAAC;QAAE,OAAO,yBAAyB,CAAC,IAAI,CAAC,CAAC;IACvD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IACrD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC7B,MAAM,WAAW,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,YAAY,GAAG,IAAI,GAAG,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IACnE,OAAO,WAAW,GAAG,yBAAyB,CAAC,IAAI,CAAC,CAAC;AACvD,CAAC"}

package/dev-settings-figlet-heading.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Large ASCII headings for dev startup banners.
+ *
+ * Why figlet: quick visual separation when four processes print similar tables
+ * in sequence — humans/agents spot which child is speaking without reading prefixes.
+ */
+/** Subsystem printed as giant ASCII above each dev settings table. */
+export type DevSubsystemBannerKind = "orchestrator" | "vite" | "api" | "electrobun";
+/**
+ * Renders a figlet block (Standard font, fits ~80 cols) for the given subsystem.
+ * On failure (missing font), falls back to a short plain marker.
+ */
+export declare function renderDevSubsystemFigletHeading(kind: DevSubsystemBannerKind, options?: {
+    maxWidth?: number;
+    font?: string;
+}): string;
+/** Figlet block, blank line, then the settings table (and any trailing footer). */
+export declare function prependDevSubsystemFigletHeading(kind: DevSubsystemBannerKind, tableAndFooter: string, options?: {
+    maxWidth?: number;
+    font?: string;
+}): string;
+//# sourceMappingURL=dev-settings-figlet-heading.d.ts.map

package/dev-settings-figlet-heading.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-settings-figlet-heading.d.ts","sourceRoot":"","sources":["../src/dev-settings-figlet-heading.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA8BH,sEAAsE;AACtE,MAAM,MAAM,sBAAsB,GAC9B,cAAc,GACd,MAAM,GACN,KAAK,GACL,YAAY,CAAC;AASjB;;;GAGG;AACH,wBAAgB,+BAA+B,CAC7C,IAAI,EAAE,sBAAsB,EAC5B,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7C,MAAM,CAkBR;AAED,mFAAmF;AACnF,wBAAgB,gCAAgC,CAC9C,IAAI,EAAE,sBAAsB,EAC5B,cAAc,EAAE,MAAM,EACtB,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7C,MAAM,CAGR"}

package/dev-settings-figlet-heading.js

@@ -0,0 +1,56 @@
+/**
+ * Large ASCII headings for dev startup banners.
+ *
+ * Why figlet: quick visual separation when four processes print similar tables
+ * in sequence — humans/agents spot which child is speaking without reading prefixes.
+ */
+import { createRequire } from "node:module";
+const require = createRequire(import.meta.url);
+function loadFiglet() {
+    try {
+        return require("figlet");
+    }
+    catch {
+        return null;
+    }
+}
+function renderFallbackHeading(text) {
+    const rule = "_".repeat(text.length + 2);
+    return [` ${rule} `, `| ${text} |`, `|${rule}|`].join("\n");
+}
+const SUBSYSTEM_FIGLET_TEXT = {
+    orchestrator: "ORCHESTRATOR",
+    vite: "VITE",
+    api: "API",
+    electrobun: "ELECTROBUN",
+};
+/**
+ * Renders a figlet block (Standard font, fits ~80 cols) for the given subsystem.
+ * On failure (missing font), falls back to a short plain marker.
+ */
+export function renderDevSubsystemFigletHeading(kind, options) {
+    const maxWidth = options?.maxWidth ?? 80;
+    const font = options?.font ?? "Standard";
+    const text = SUBSYSTEM_FIGLET_TEXT[kind];
+    const figlet = loadFiglet();
+    if (!figlet) {
+        return renderFallbackHeading(text);
+    }
+    try {
+        const block = figlet.textSync(text, {
+            font,
+            width: maxWidth,
+            whitespaceBreak: true,
+        });
+        return block.replace(/\s+$/u, "");
+    }
+    catch {
+        return renderFallbackHeading(text);
+    }
+}
+/** Figlet block, blank line, then the settings table (and any trailing footer). */
+export function prependDevSubsystemFigletHeading(kind, tableAndFooter, options) {
+    const head = renderDevSubsystemFigletHeading(kind, options);
+    return `${head}\n\n${tableAndFooter}`;
+}
+//# sourceMappingURL=dev-settings-figlet-heading.js.map

package/dev-settings-figlet-heading.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-settings-figlet-heading.js","sourceRoot":"","sources":["../src/dev-settings-figlet-heading.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAa5C,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAE/C,SAAS,UAAU;IACjB,IAAI,CAAC;QACH,OAAO,OAAO,CAAC,QAAQ,CAAiB,CAAC;IAC3C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,qBAAqB,CAAC,IAAY;IACzC,MAAM,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACzC,OAAO,CAAC,IAAI,IAAI,GAAG,EAAE,KAAK,IAAI,IAAI,EAAE,IAAI,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC9D,CAAC;AASD,MAAM,qBAAqB,GAA2C;IACpE,YAAY,EAAE,cAAc;IAC5B,IAAI,EAAE,MAAM;IACZ,GAAG,EAAE,KAAK;IACV,UAAU,EAAE,YAAY;CACzB,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,+BAA+B,CAC7C,IAA4B,EAC5B,OAA8C;IAE9C,MAAM,QAAQ,GAAG,OAAO,EAAE,QAAQ,IAAI,EAAE,CAAC;IACzC,MAAM,IAAI,GAAG,OAAO,EAAE,IAAI,IAAI,UAAU,CAAC;IACzC,MAAM,IAAI,GAAG,qBAAqB,CAAC,IAAI,CAAC,CAAC;IACzC,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAC5B,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,qBAAqB,CAAC,IAAI,CAAC,CAAC;IACrC,CAAC;IACD,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE;YAClC,IAAI;YACJ,KAAK,EAAE,QAAQ;YACf,eAAe,EAAE,IAAI;SACtB,CAAC,CAAC;QACH,OAAO,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IACpC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,qBAAqB,CAAC,IAAI,CAAC,CAAC;IACrC,CAAC;AACH,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,gCAAgC,CAC9C,IAA4B,EAC5B,cAAsB,EACtB,OAA8C;IAE9C,MAAM,IAAI,GAAG,+BAA+B,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC5D,OAAO,GAAG,IAAI,OAAO,cAAc,EAAE,CAAC;AACxC,CAAC"}

package/dev-settings-table.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Plain-text tables for dev startup banners (orchestrator, Vite, API, Electrobun).
+ * Narrow layout uses Unicode box drawing (no ANSI here). Use `dev-settings-banner-style`
+ * when printing to a TTY for cyan emphasis.
+ *
+ * Why: Multi-process desktop dev prints four overlapping env snapshots; a framed
+ * table makes effective ports and sources scannable in the terminal (developer
+ * observability, not end-user product UI).
+ */
+export type DevSettingsRow = {
+    setting: string;
+    effective: string;
+    source: string;
+    change: string;
+};
+declare const DEFAULT_CAPS: {
+    readonly setting: 44;
+    readonly effective: 16;
+    readonly source: 52;
+    readonly change: 64;
+};
+export type DevSettingsTableOptions = {
+    caps?: Partial<typeof DEFAULT_CAPS>;
+    /** Multiline ~80 cols by default; set `wide` for legacy single-line table. */
+    layout?: "wide" | "narrow";
+    /** Max line length for `layout: "narrow"` (default 80). */
+    narrowWidth?: number;
+    /**
+     * When `layout` is `narrow`, draw a Unicode frame (default true).
+     * Set false for plain `=== title ===` blocks (e.g. tests or log capture).
+     */
+    narrowFrame?: boolean;
+};
+/** Word-wrap to at most `width` columns; breaks on spaces, then hard-breaks long tokens. */
+export declare function wrapToWidth(text: string, width: number): string[];
+/**
+ * Multiline block per row; each output line ≤ outerWidth (default 80).
+ * When `frame` is true, draws a light Unicode border; inner text wraps to fit.
+ */
+export declare function formatDevSettingsTableNarrow(title: string, rows: DevSettingsRow[], outerWidth?: number, frame?: boolean): string;
+/**
+ * Format a titled dev settings banner. Default is multiline (~80 cols); pass
+ * `layout: "wide"` for the legacy four-column table with Setting/Effective/Source/Change header.
+ */
+export declare function formatDevSettingsTable(title: string, rows: DevSettingsRow[], options?: DevSettingsTableOptions): string;
+export {};
+//# sourceMappingURL=dev-settings-table.d.ts.map

package/dev-settings-table.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-settings-table.d.ts","sourceRoot":"","sources":["../src/dev-settings-table.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,MAAM,cAAc,GAAG;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,QAAA,MAAM,YAAY;;;;;CAKR,CAAC;AAEX,MAAM,MAAM,uBAAuB,GAAG;IACpC,IAAI,CAAC,EAAE,OAAO,CAAC,OAAO,YAAY,CAAC,CAAC;IACpC,8EAA8E;IAC9E,MAAM,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;IAC3B,2DAA2D;IAC3D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,CAAC;AAQF,4FAA4F;AAC5F,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAkBjE;AA+ED;;;GAGG;AACH,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,cAAc,EAAE,EACtB,UAAU,SAAK,EACf,KAAK,UAAO,GACX,MAAM,CA2BR;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,cAAc,EAAE,EACtB,OAAO,CAAC,EAAE,uBAAuB,GAChC,MAAM,CA+CR"}

package/dev-settings-table.js

@@ -0,0 +1,189 @@
+/**
+ * Plain-text tables for dev startup banners (orchestrator, Vite, API, Electrobun).
+ * Narrow layout uses Unicode box drawing (no ANSI here). Use `dev-settings-banner-style`
+ * when printing to a TTY for cyan emphasis.
+ *
+ * Why: Multi-process desktop dev prints four overlapping env snapshots; a framed
+ * table makes effective ports and sources scannable in the terminal (developer
+ * observability, not end-user product UI).
+ */
+const DEFAULT_CAPS = {
+    setting: 44,
+    effective: 16,
+    source: 52,
+    change: 64,
+};
+function truncateCell(value, maxWidth) {
+    if (value.length <= maxWidth)
+        return value;
+    if (maxWidth < 2)
+        return value.slice(0, maxWidth);
+    return `${value.slice(0, maxWidth - 1)}…`;
+}
+/** Word-wrap to at most `width` columns; breaks on spaces, then hard-breaks long tokens. */
+export function wrapToWidth(text, width) {
+    if (width < 1)
+        return [text];
+    const normalized = text.replace(/\s+/g, " ").trim();
+    if (!normalized)
+        return [""];
+    const lines = [];
+    let remaining = normalized;
+    while (remaining.length > 0) {
+        if (remaining.length <= width) {
+            lines.push(remaining);
+            break;
+        }
+        let breakAt = remaining.lastIndexOf(" ", width);
+        if (breakAt <= 0)
+            breakAt = width;
+        const chunk = remaining.slice(0, breakAt).trimEnd();
+        lines.push(chunk.length > 0 ? chunk : remaining.slice(0, width));
+        remaining = remaining.slice(breakAt === width ? width : breakAt).trimStart();
+    }
+    return lines;
+}
+function emitLabeledLines(label, value, maxWidth) {
+    const prefix = `  ${label}: `;
+    const budget = maxWidth - prefix.length;
+    if (budget < 12) {
+        return [
+            `  ${label}:`,
+            ...wrapToWidth(value, Math.max(8, maxWidth - 2)).map((l) => `    ${l}`),
+        ];
+    }
+    const wrapped = wrapToWidth(value, budget);
+    const out = [`${prefix}${wrapped[0] ?? ""}`];
+    const pad = " ".repeat(prefix.length);
+    for (let j = 1; j < wrapped.length; j++)
+        out.push(`${pad}${wrapped[j]}`);
+    return out;
+}
+function boxTopRule(title, outer) {
+    const inner = outer - 2;
+    if (inner < 4)
+        return title.slice(0, Math.max(0, outer));
+    const maxTitle = Math.max(1, inner - 4);
+    let t = title;
+    if (t.length > maxTitle)
+        t = `${t.slice(0, Math.max(1, maxTitle - 1))}…`;
+    const padDash = inner - 2 - t.length;
+    const left = Math.max(0, Math.floor(padDash / 2));
+    const right = Math.max(0, padDash - left);
+    return `╭${"─".repeat(left)} ${t} ${"─".repeat(right)}╮`;
+}
+function boxMidRule(outer) {
+    const inner = outer - 2;
+    return `├${"─".repeat(inner)}┤`;
+}
+function boxBottomRule(outer) {
+    const inner = outer - 2;
+    return `╰${"─".repeat(inner)}╯`;
+}
+function boxEmptyRow(outer) {
+    const inner = outer - 2;
+    return `│${" ".repeat(inner)}│`;
+}
+function boxRow(line, outer) {
+    const inner = outer - 2;
+    const maxMid = Math.max(0, inner - 4);
+    const vis = line.length > maxMid
+        ? `${line.slice(0, Math.max(0, maxMid - 1))}…`
+        : line;
+    const pad = maxMid - vis.length;
+    return `│ ${vis}${" ".repeat(pad)} │`;
+}
+function formatDevSettingsTableNarrowUnframed(title, rows, maxWidth) {
+    const sep = "—".repeat(Math.min(maxWidth, 40));
+    const lines = [`=== ${title} ===`, ""];
+    for (let i = 0; i < rows.length; i++) {
+        const r = rows[i];
+        lines.push(...wrapToWidth(r.setting, maxWidth));
+        lines.push(...emitLabeledLines("Effective", r.effective, maxWidth));
+        lines.push(...emitLabeledLines("Source", r.source, maxWidth));
+        lines.push(...emitLabeledLines("Change", r.change, maxWidth));
+        if (i < rows.length - 1)
+            lines.push("", sep, "");
+        else
+            lines.push("");
+    }
+    return `${lines.join("\n")}\n`;
+}
+/**
+ * Multiline block per row; each output line ≤ outerWidth (default 80).
+ * When `frame` is true, draws a light Unicode border; inner text wraps to fit.
+ */
+export function formatDevSettingsTableNarrow(title, rows, outerWidth = 80, frame = true) {
+    if (!frame) {
+        return formatDevSettingsTableNarrowUnframed(title, rows, outerWidth);
+    }
+    const outer = Math.max(24, outerWidth);
+    const inner = outer - 2;
+    const contentW = Math.max(8, inner - 4);
+    const lines = [];
+    lines.push(boxTopRule(title, outer));
+    lines.push(boxEmptyRow(outer));
+    for (let i = 0; i < rows.length; i++) {
+        const r = rows[i];
+        const block = [];
+        block.push(...wrapToWidth(r.setting, contentW));
+        block.push(...emitLabeledLines("Effective", r.effective, contentW));
+        block.push(...emitLabeledLines("Source", r.source, contentW));
+        block.push(...emitLabeledLines("Change", r.change, contentW));
+        for (const ln of block)
+            lines.push(boxRow(ln, outer));
+        if (i < rows.length - 1) {
+            lines.push(boxEmptyRow(outer));
+            lines.push(boxMidRule(outer));
+            lines.push(boxEmptyRow(outer));
+        }
+    }
+    lines.push(boxEmptyRow(outer));
+    lines.push(boxBottomRule(outer));
+    return `${lines.join("\n")}\n`;
+}
+/**
+ * Format a titled dev settings banner. Default is multiline (~80 cols); pass
+ * `layout: "wide"` for the legacy four-column table with Setting/Effective/Source/Change header.
+ */
+export function formatDevSettingsTable(title, rows, options) {
+    const layout = options?.layout ?? "narrow";
+    if (layout === "narrow") {
+        return formatDevSettingsTableNarrow(title, rows, options?.narrowWidth ?? 80, options?.narrowFrame !== false);
+    }
+    const caps = { ...DEFAULT_CAPS, ...options?.caps };
+    const header = {
+        setting: "Setting",
+        effective: "Effective",
+        source: "Source",
+        change: "Change",
+    };
+    let w0 = header.setting.length;
+    let w1 = header.effective.length;
+    let w2 = header.source.length;
+    let w3 = header.change.length;
+    for (const r of rows) {
+        w0 = Math.max(w0, r.setting.length);
+        w1 = Math.max(w1, r.effective.length);
+        w2 = Math.max(w2, r.source.length);
+        w3 = Math.max(w3, r.change.length);
+    }
+    w0 = Math.min(caps.setting, w0);
+    w1 = Math.min(caps.effective, w1);
+    w2 = Math.min(caps.source, w2);
+    w3 = Math.min(caps.change, w3);
+    const fmt = (r) => [
+        truncateCell(r.setting, w0).padEnd(w0),
+        truncateCell(r.effective, w1).padEnd(w1),
+        truncateCell(r.source, w2).padEnd(w2),
+        truncateCell(r.change, w3),
+    ].join("  ");
+    const lines = [
+        `=== ${title} ===`,
+        fmt(header),
+        "-".repeat(w0 + w1 + w2 + w3 + 6),
+        ...rows.map(fmt),
+    ];
+    return `${lines.join("\n")}\n`;
+}
+//# sourceMappingURL=dev-settings-table.js.map

package/dev-settings-table.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-settings-table.js","sourceRoot":"","sources":["../src/dev-settings-table.ts"],"names":[],"mappings":"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"}

package/eliza-core-roles.d.ts

@@ -0,0 +1,70 @@
+import { type IAgentRuntime, type Memory, type Role, type UUID, type World } from "@elizaos/core";
+export type RoleName = "OWNER" | "ADMIN" | "USER" | "GUEST";
+export type RoleGrantSource = "owner" | "manual" | "connector_admin";
+export declare const ROLE_RANK: Record<RoleName, number>;
+export type RolesWorldMetadata = {
+    ownership?: {
+        ownerId?: string;
+    };
+    roles?: Record<string, RoleName>;
+    roleSources?: Record<string, RoleGrantSource>;
+};
+export type ConnectorAdminWhitelist = Record<string, string[]>;
+export type RolesConfig = {
+    connectorAdmins?: ConnectorAdminWhitelist;
+};
+export type RoleCheckResult = {
+    entityId: UUID;
+    role: RoleName;
+    isOwner: boolean;
+    isAdmin: boolean;
+    canManageRoles: boolean;
+};
+export interface ServerOwnershipState {
+    servers: {
+        [serverId: string]: World;
+    };
+}
+declare const CONNECTOR_ID_FIELDS: readonly ["userId", "id", "username", "userName"];
+type ConnectorIdField = (typeof CONNECTOR_ID_FIELDS)[number];
+type ConnectorAdminMatch = {
+    connector: string;
+    matchedValue: string;
+    matchedField: ConnectorIdField;
+};
+type ResolveEntityRoleOptions = {
+    liveEntityMetadata?: Record<string, unknown> | null;
+    liveEntityId?: string;
+};
+export declare function getUserServerRole(runtime: IAgentRuntime, entityId: string, serverId: string): Promise<Role>;
+export declare function findWorldsForOwner(runtime: IAgentRuntime, entityId: string): Promise<World[] | null>;
+export declare function getConfiguredOwnerEntityIds(runtime: IAgentRuntime): string[];
+export declare function hasConfiguredCanonicalOwner(runtime: IAgentRuntime): boolean;
+export declare function resolveCanonicalOwnerId(runtime: IAgentRuntime, metadata?: RolesWorldMetadata): string | null;
+export declare function setConnectorAdminWhitelist(runtime: IAgentRuntime, whitelist: ConnectorAdminWhitelist | Record<string, unknown> | undefined): void;
+export declare function getConnectorAdminWhitelist(runtime: IAgentRuntime): ConnectorAdminWhitelist;
+export declare function matchEntityToConnectorAdminWhitelist(entityMetadata: Record<string, unknown> | null | undefined, whitelist: ConnectorAdminWhitelist | Record<string, unknown> | undefined): ConnectorAdminMatch | null;
+export declare function normalizeRole(raw: string | undefined | null): RoleName;
+export declare function getEntityRole(metadata: RolesWorldMetadata | undefined, entityId: string): RoleName;
+export declare function getLiveEntityMetadataFromMessage(message: Memory): Record<string, unknown> | undefined;
+export declare function resolveEntityRole(runtime: IAgentRuntime, _world: Awaited<ReturnType<IAgentRuntime["getWorld"]>>, metadata: RolesWorldMetadata | undefined, entityId: string, options?: ResolveEntityRoleOptions): Promise<RoleName>;
+export declare function checkSenderPrivateAccess(runtime: IAgentRuntime, message: Memory): Promise<{
+    entityId: UUID;
+    role: RoleName;
+    isOwner: boolean;
+    isAdmin: boolean;
+    canManageRoles: boolean;
+    hasPrivateAccess: boolean;
+    accessRole: RoleName | null;
+    accessSource: "owner" | "manual" | "linked_manual" | null;
+} | null>;
+export declare function canModifyRole(actorRole: RoleName, targetCurrentRole: RoleName, newRole: RoleName): boolean;
+export declare function resolveWorldForMessage(runtime: IAgentRuntime, message: Memory): Promise<{
+    world: Awaited<ReturnType<IAgentRuntime["getWorld"]>>;
+    metadata: RolesWorldMetadata;
+} | null>;
+export declare function resolveCanonicalOwnerIdForMessage(runtime: IAgentRuntime, message: Memory): Promise<string | null>;
+export declare function checkSenderRole(runtime: IAgentRuntime, message: Memory): Promise<RoleCheckResult | null>;
+export declare function setEntityRole(runtime: IAgentRuntime, message: Memory, targetEntityId: string, newRole: RoleName, source?: RoleGrantSource): Promise<Record<string, RoleName>>;
+export {};
+//# sourceMappingURL=eliza-core-roles.d.ts.map

package/eliza-core-roles.d.ts.map

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