@elizaos/agent 2.0.0-beta.2 → 2.0.11-beta.6

package/api/suggestions-routes.js

@@ -0,0 +1,301 @@
+/**
+ * POST /api/suggestions — server-tailored tap-to-send prompt suggestions for
+ * the continuous-chat overlay's resting composer strip (#8225).
+ *
+ * The client sends recent conversation context, the local hour, and the
+ * active page scope ("page-lifeops", "page-browser", …). Two tiers:
+ *
+ * - `model`     — the small text model writes EXACTLY 3 short, first-person
+ *                 prompts tailored to the character, the conversation, and
+ *                 the active view.
+ * - `heuristic` — a deterministic, zero-model-call set derived from scope +
+ *                 thread state + time of day. Served when no runtime/model
+ *                 is available or generation fails, and used to pad a short
+ *                 model set — the response is never empty
+ *                 (degrade-not-empty).
+ *
+ * Response: `{ suggestions: string[3], tier: "model" | "heuristic",
+ * generatedAt: ISO }`. Clients that only read `suggestions` keep working.
+ */
+import { ModelType, readRequestBodyBuffer, } from "@elizaos/core";
+const MAX_BODY_BYTES = 16 * 1024;
+const SUGGESTION_COUNT = 3;
+const MAX_SUGGESTION_CHARS = 48;
+const MIN_SUGGESTION_CHARS = 2;
+const MAX_CONTEXT_MESSAGES = 6;
+const MAX_CONTEXT_CHARS = 240;
+/** Page scopes mirror `PageScope` in @elizaos/ui (page-scoped-conversations). */
+const PAGE_SCOPE_PATTERN = /^page-[a-z][a-z0-9-]{1,30}$/;
+const EMPTY_REQUEST = {
+    messages: [],
+    hour: undefined,
+    scope: undefined,
+};
+export function parseRequestBody(raw) {
+    if (!raw.trim())
+        return { ...EMPTY_REQUEST };
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        return { ...EMPTY_REQUEST };
+    }
+    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+        return { ...EMPTY_REQUEST };
+    }
+    const body = parsed;
+    const messages = [];
+    if (Array.isArray(body.messages)) {
+        for (const entry of body.messages) {
+            if (!entry || typeof entry !== "object")
+                continue;
+            const record = entry;
+            const role = record.role === "assistant" ? "assistant" : "user";
+            const content = typeof record.content === "string" ? record.content.trim() : "";
+            if (!content)
+                continue;
+            messages.push({ role, content: content.slice(0, MAX_CONTEXT_CHARS) });
+        }
+    }
+    const hourValue = body.hour;
+    const hour = typeof hourValue === "number" &&
+        Number.isFinite(hourValue) &&
+        hourValue >= 0 &&
+        hourValue <= 23
+        ? Math.floor(hourValue)
+        : undefined;
+    const scope = typeof body.scope === "string" && PAGE_SCOPE_PATTERN.test(body.scope)
+        ? body.scope
+        : undefined;
+    return { messages: messages.slice(-MAX_CONTEXT_MESSAGES), hour, scope };
+}
+// ---------------------------------------------------------------------------
+// Heuristic tier — deterministic, zero model calls (#8225 Phase-1)
+// ---------------------------------------------------------------------------
+/** Per-scope starters; each obeys the same 2–6-word, ≤48-char suggestion rules. */
+const SCOPE_STARTERS = {
+    "page-browser": [
+        "Summarize this page",
+        "Search the web for me",
+        "Find sources for this",
+    ],
+    "page-character": [
+        "Tune your personality",
+        "Change your voice",
+        "What can you do?",
+    ],
+    "page-automations": [
+        "Create a daily routine",
+        "List my automations",
+        "What ran today?",
+    ],
+    "page-apps": ["What apps do I have?", "Recommend an app", "Build me an app"],
+    "page-connectors": [
+        "Check my connections",
+        "Connect a new service",
+        "Any connector errors?",
+    ],
+    "page-phone": ["Call a contact", "Read my messages", "Text someone for me"],
+    "page-plugins": [
+        "What plugins are active?",
+        "Suggest a plugin",
+        "Configure a plugin",
+    ],
+    "page-lifeops": ["Plan my day", "What's on my plate?", "Review my reminders"],
+    "page-settings": [
+        "Review my settings",
+        "Switch my model",
+        "Tighten my privacy",
+    ],
+    "page-wallet": ["Check my balance", "Recent transactions", "Send a payment"],
+};
+const GENERAL_STARTERS = [
+    "What can you do?",
+    "Summarize my day",
+    "Draft a reply",
+    "What's on my plate?",
+    "Explain this for me",
+];
+const THREAD_FOLLOW_UP = "Continue where we left off";
+function heuristicLead(hour) {
+    if (hour === undefined)
+        return GENERAL_STARTERS[0];
+    if (hour >= 5 && hour < 12)
+        return "Plan my day";
+    if (hour >= 12 && hour < 18)
+        return "What's left today?";
+    return "Recap my day";
+}
+/**
+ * Deterministic suggestions from scope + thread state + time of day. Always
+ * returns exactly {@link SUGGESTION_COUNT} unique items — the
+ * degrade-not-empty floor under the model tier.
+ */
+export function computeHeuristicSuggestions(request) {
+    const hasThread = request.messages.length > 0;
+    const lead = hasThread ? THREAD_FOLLOW_UP : heuristicLead(request.hour);
+    const scoped = (request.scope && SCOPE_STARTERS[request.scope]) || [];
+    return Array.from(new Set([lead, ...scoped, ...GENERAL_STARTERS])).slice(0, SUGGESTION_COUNT);
+}
+function timeOfDay(hour) {
+    if (hour === undefined)
+        return "right now";
+    if (hour >= 5 && hour < 12)
+        return "this morning";
+    if (hour >= 12 && hour < 18)
+        return "this afternoon";
+    if (hour >= 18 && hour < 22)
+        return "this evening";
+    return "tonight";
+}
+function characterHint(runtime) {
+    const name = runtime.character?.name?.trim() || "the assistant";
+    const bioRaw = runtime.character?.bio;
+    const bio = Array.isArray(bioRaw)
+        ? bioRaw.join(" ")
+        : typeof bioRaw === "string"
+            ? bioRaw
+            : "";
+    const trimmedBio = bio.trim().slice(0, 240);
+    return trimmedBio
+        ? `The assistant is ${name}: ${trimmedBio}`
+        : `The assistant is ${name}.`;
+}
+function buildPrompt(runtime, request) {
+    const conversation = request.messages.length
+        ? request.messages
+            .map((m) => `${m.role === "user" ? "User" : "Assistant"}: ${m.content}`)
+            .join("\n")
+        : "No conversation yet.";
+    // "page-lifeops" → "lifeops" — a human-readable view name for the prompt.
+    const viewName = request.scope?.replace(/^page-/, "");
+    return [
+        `You write tap-to-send prompt suggestions for a chat composer. ${characterHint(runtime)}`,
+        "",
+        `Return JSON only, exactly this shape with EXACTLY ${SUGGESTION_COUNT} items:`,
+        '{"suggestions":["...","...","..."]}',
+        "",
+        "Each suggestion is the NEXT thing the user might say to the assistant,",
+        "written in first person from the user's point of view.",
+        "Rules:",
+        "- 2 to 6 words. Imperative or a short question. No trailing punctuation except '?'.",
+        "- Concrete and immediately useful. No greetings, no 'hello', no emoji.",
+        "- Do not number them, quote them, or add bullets inside the strings.",
+        `- If a conversation is present, suggest natural follow-ups to it; otherwise offer broadly useful first moves for ${timeOfDay(request.hour)}.`,
+        ...(viewName
+            ? [
+                `- The user is currently on the "${viewName}" view of the app; bias at least one suggestion toward what they'd do there.`,
+            ]
+            : []),
+        "",
+        "Conversation so far:",
+        conversation,
+    ].join("\n");
+}
+function parseJsonObject(text) {
+    const trimmed = text.trim();
+    if (!trimmed)
+        return null;
+    const attempt = (candidate) => {
+        try {
+            const value = JSON.parse(candidate);
+            return value && typeof value === "object" && !Array.isArray(value)
+                ? value
+                : null;
+        }
+        catch {
+            return null;
+        }
+    };
+    const direct = attempt(trimmed);
+    if (direct)
+        return direct;
+    const start = trimmed.indexOf("{");
+    const end = trimmed.lastIndexOf("}");
+    if (start === -1 || end <= start)
+        return null;
+    return attempt(trimmed.slice(start, end + 1));
+}
+export function cleanSuggestions(value) {
+    if (!Array.isArray(value))
+        return [];
+    const seen = new Set();
+    const out = [];
+    for (const raw of value) {
+        if (typeof raw !== "string")
+            continue;
+        const cleaned = raw
+            .replace(/^\s*[-*\d.)\]]+\s*/, "") // leading bullet / "1." / "2)"
+            .replace(/^["'`]+|["'`]+$/g, "") // wrapping quotes
+            .replace(/\s+/g, " ")
+            .trim();
+        if (cleaned.length < MIN_SUGGESTION_CHARS)
+            continue;
+        if (cleaned.length > MAX_SUGGESTION_CHARS)
+            continue;
+        const key = cleaned.toLowerCase();
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        out.push(cleaned);
+        if (out.length >= SUGGESTION_COUNT)
+            break;
+    }
+    return out;
+}
+/** Pad a (possibly short) model set up to the full count from the heuristic tier. */
+function padWithHeuristics(modelSuggestions, request) {
+    const seen = new Set(modelSuggestions.map((s) => s.toLowerCase()));
+    const padded = [...modelSuggestions];
+    for (const candidate of computeHeuristicSuggestions(request)) {
+        if (padded.length >= SUGGESTION_COUNT)
+            break;
+        if (seen.has(candidate.toLowerCase()))
+            continue;
+        seen.add(candidate.toLowerCase());
+        padded.push(candidate);
+    }
+    return {
+        suggestions: padded.slice(0, SUGGESTION_COUNT),
+        tier: modelSuggestions.length > 0 ? "model" : "heuristic",
+        generatedAt: new Date().toISOString(),
+    };
+}
+export async function handleSuggestionsRoutes(ctx) {
+    const { req, res, method, pathname, json, error, runtime } = ctx;
+    if (pathname !== "/api/suggestions")
+        return false;
+    if (method !== "POST") {
+        error(res, "Method not allowed", 405);
+        return true;
+    }
+    const buffer = await readRequestBodyBuffer(req, {
+        maxBytes: MAX_BODY_BYTES,
+        returnNullOnTooLarge: true,
+    });
+    const request = parseRequestBody(buffer?.toString("utf8") ?? "");
+    // No runtime → serve the deterministic tier (degrade-not-empty, #8225).
+    if (!runtime) {
+        json(res, padWithHeuristics([], request));
+        return true;
+    }
+    try {
+        const raw = await runtime.useModel(ModelType.TEXT_SMALL, {
+            prompt: buildPrompt(runtime, request),
+            maxTokens: 160,
+            temperature: 0.8,
+            responseFormat: { type: "json_object" },
+        });
+        const parsed = parseJsonObject(typeof raw === "string" ? raw : "");
+        json(res, padWithHeuristics(cleanSuggestions(parsed?.suggestions), request));
+    }
+    catch (err) {
+        runtime.logger.warn({
+            src: "api:suggestions",
+            error: err instanceof Error ? err.message : String(err),
+        }, "Prompt suggestion generation failed; serving heuristic tier");
+        json(res, padWithHeuristics([], request));
+    }
+    return true;
+}

package/api/task-agent-message-routing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-agent-message-routing.d.ts","sourceRoot":"","sources":["../../src/api/task-agent-message-routing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAQ,MAAM,eAAe,CAAC;AAExD,MAAM,WAAW,oBAAoB;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAkBD,KAAK,cAAc,GAAG,IAAI,CACxB,YAAY,EACZ,SAAS,GAAG,YAAY,GAAG,qBAAqB,CACjD,CAAC;AAsCF,wBAAsB,6BAA6B,CACjD,OAAO,EAAE,cAAc,GAAG,IAAI,EAC9B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,OAAO,CAAC,CA0ClB"}

package/api/terminal-execution-routing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-execution-routing.d.ts","sourceRoot":"","sources":["../../src/api/terminal-execution-routing.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAErE,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,cAAc,EAAE,cAAc,GAAG,IAAI,CAAC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,6BAA6B,CAAC,IAAI,EAAE;IAClD,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;IAC3D,cAAc,EAAE,cAAc,GAAG,IAAI,CAAC;CACvC,GAAG,sBAAsB,CAWzB;AAED,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAOxE"}

package/api/terminal-run-limits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-run-limits.d.ts","sourceRoot":"","sources":["../../src/api/terminal-run-limits.ts"],"names":[],"mappings":"AAOA,wBAAgB,wBAAwB,IAAI;IAC1C,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;CACvB,CAgBA"}

package/api/terminal-run-limits.js

@@ -0,0 +1,20 @@
+import { parseClampedInteger } from "@elizaos/shared";
+const TERMINAL_RUN_MAX_CONCURRENT_DEFAULT = 2;
+const TERMINAL_RUN_MAX_CONCURRENT_CAP = 16;
+const TERMINAL_RUN_MAX_DURATION_MS_DEFAULT = 5 * 60 * 1000;
+const TERMINAL_RUN_MAX_DURATION_MS_CAP = 60 * 60 * 1000;
+export function resolveTerminalRunLimits() {
+    const maxConcurrentRaw = process.env.ELIZA_TERMINAL_MAX_CONCURRENT;
+    const maxConcurrent = parseClampedInteger(maxConcurrentRaw, {
+        fallback: TERMINAL_RUN_MAX_CONCURRENT_DEFAULT,
+        min: 1,
+        max: TERMINAL_RUN_MAX_CONCURRENT_CAP,
+    });
+    const maxDurationMsRaw = process.env.ELIZA_TERMINAL_MAX_DURATION_MS;
+    const maxDurationMs = parseClampedInteger(maxDurationMsRaw, {
+        fallback: TERMINAL_RUN_MAX_DURATION_MS_DEFAULT,
+        min: 1_000,
+        max: TERMINAL_RUN_MAX_DURATION_MS_CAP,
+    });
+    return { maxConcurrent, maxDurationMs };
+}

package/api/trade-safety.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Pure trade safety utilities — no heavy dependencies.
+ * Extracted so they can be unit-tested without pulling in the full server.
+ */
+export type { TradePermissionMode } from "@elizaos/shared";
+import type { TradePermissionMode } from "@elizaos/shared";
+/** Maximum number of autonomous agent trades allowed per calendar day. */
+export declare const AGENT_AUTO_MAX_DAILY_TRADES = 25;
+/** Maximum age of a trade quote before it is considered stale. */
+export declare const QUOTE_MAX_AGE_MS = 60000;
+/** Tracks autonomous trade count for rate-limiting in agent-auto mode. */
+export declare const agentAutoDailyTrades: {
+    count: number;
+    resetDate: string;
+};
+export declare function getAgentAutoTradeDate(): string;
+/**
+ * Record an autonomous agent trade. Returns true if allowed, false if
+ * the daily limit has been reached. Resets the counter on a new calendar day.
+ */
+export declare function recordAgentAutoTrade(log?: (msg: string) => void): boolean;
+type LocalTradeExecutionOptions = {
+    consumeAgentQuota?: boolean;
+};
+/**
+ * Returns true if local-key execution is permitted for the given actor.
+ */
+export declare function canUseLocalTradeExecution(mode: TradePermissionMode, isAgent: boolean, log?: (msg: string) => void, options?: LocalTradeExecutionOptions): boolean;
+/**
+ * Assert that a trade quote is still fresh. Fails closed: a missing or
+ * non-finite `quotedAt` cannot be proven fresh and is rejected, as is any
+ * quote older than QUOTE_MAX_AGE_MS.
+ */
+export declare function assertQuoteFresh(quotedAt: number | undefined, now?: number): void;
+//# sourceMappingURL=trade-safety.d.ts.map

package/api/trade-safety.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trade-safety.d.ts","sourceRoot":"","sources":["../../src/api/trade-safety.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,YAAY,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAE3D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAE3D,0EAA0E;AAC1E,eAAO,MAAM,2BAA2B,KAAK,CAAC;AAE9C,kEAAkE;AAClE,eAAO,MAAM,gBAAgB,QAAS,CAAC;AAEvC,0EAA0E;AAC1E,eAAO,MAAM,oBAAoB;;;CAA8B,CAAC;AAEhE,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAiBzE;AAED,KAAK,0BAA0B,GAAG;IAChC,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B,CAAC;AAEF;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,mBAAmB,EACzB,OAAO,EAAE,OAAO,EAChB,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,EAC3B,OAAO,GAAE,0BAA+B,GACvC,OAAO,CAgBT;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,GAAG,GAAE,MAAmB,GACvB,IAAI,CASN"}

package/api/trade-safety.js

@@ -0,0 +1,65 @@
+/**
+ * Pure trade safety utilities — no heavy dependencies.
+ * Extracted so they can be unit-tested without pulling in the full server.
+ */
+/** Maximum number of autonomous agent trades allowed per calendar day. */
+export const AGENT_AUTO_MAX_DAILY_TRADES = 25;
+/** Maximum age of a trade quote before it is considered stale. */
+export const QUOTE_MAX_AGE_MS = 60_000; // 60 seconds
+/** Tracks autonomous trade count for rate-limiting in agent-auto mode. */
+export const agentAutoDailyTrades = { count: 0, resetDate: "" };
+export function getAgentAutoTradeDate() {
+    return new Date().toISOString().slice(0, 10);
+}
+/**
+ * Record an autonomous agent trade. Returns true if allowed, false if
+ * the daily limit has been reached. Resets the counter on a new calendar day.
+ */
+export function recordAgentAutoTrade(log) {
+    const today = getAgentAutoTradeDate();
+    if (agentAutoDailyTrades.resetDate !== today) {
+        agentAutoDailyTrades.count = 0;
+        agentAutoDailyTrades.resetDate = today;
+    }
+    if (agentAutoDailyTrades.count >= AGENT_AUTO_MAX_DAILY_TRADES) {
+        log?.(`[trade] Agent-auto daily trade limit reached (${AGENT_AUTO_MAX_DAILY_TRADES}). Rejecting autonomous trade.`);
+        return false;
+    }
+    agentAutoDailyTrades.count += 1;
+    log?.(`[trade] Agent-auto autonomous trade ${agentAutoDailyTrades.count}/${AGENT_AUTO_MAX_DAILY_TRADES} for ${today}`);
+    return true;
+}
+/**
+ * Returns true if local-key execution is permitted for the given actor.
+ */
+export function canUseLocalTradeExecution(mode, isAgent, log, options = {}) {
+    if (mode === "agent-auto") {
+        if (isAgent) {
+            if (options.consumeAgentQuota === false) {
+                const today = getAgentAutoTradeDate();
+                if (agentAutoDailyTrades.resetDate !== today) {
+                    return true;
+                }
+                return agentAutoDailyTrades.count < AGENT_AUTO_MAX_DAILY_TRADES;
+            }
+            return recordAgentAutoTrade(log);
+        }
+        return true;
+    }
+    if (mode === "manual-local-key")
+        return !isAgent;
+    return false;
+}
+/**
+ * Assert that a trade quote is still fresh. Fails closed: a missing or
+ * non-finite `quotedAt` cannot be proven fresh and is rejected, as is any
+ * quote older than QUOTE_MAX_AGE_MS.
+ */
+export function assertQuoteFresh(quotedAt, now = Date.now()) {
+    if (typeof quotedAt !== "number" || !Number.isFinite(quotedAt)) {
+        throw new Error("Quote is missing a timestamp — please request a fresh quote");
+    }
+    if (now - quotedAt > QUOTE_MAX_AGE_MS) {
+        throw new Error("Quote expired — please request a fresh quote");
+    }
+}

package/api/training-backend-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"training-backend-check.d.ts","sourceRoot":"","sources":["../../src/api/training-backend-check.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,OAAO,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;IACd,GAAG,EAAE,OAAO,CAAC;CACd;AAcD,wBAAsB,uBAAuB,IAAI,OAAO,CAAC,mBAAmB,CAAC,CAe5E;AAED,wBAAgB,iBAAiB,IAAI,IAAI,CAExC"}

package/api/training-service-like.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"training-service-like.d.ts","sourceRoot":"","sources":["../../src/api/training-service-like.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAE/E,MAAM,WAAW,mBAAmB;IAClC,SAAS,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,gBAAgB,CAAC,OAAO,EAAE;QACxB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAClC,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IACpE,YAAY,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IAC1C,YAAY,CAAC,OAAO,EAAE;QACpB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,wBAAwB,CAAC,EAAE,MAAM,CAAC;KACnC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACrC,QAAQ,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IACtC,gBAAgB,CAAC,OAAO,EAAE;QACxB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,OAAO,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,CAAC;QACjC,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACrC,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACtD,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC3D,UAAU,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IACxC,mBAAmB,CACjB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE;QACJ,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,GACA,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACpC,aAAa,CACX,OAAO,EAAE,MAAM,EACf,aAAa,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACpC,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACnE;AAED,MAAM,WAAW,0BAA2B,SAAQ,mBAAmB;IACrE,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,SAAS,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;CAC3D"}

package/api/tx-service.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Ethereum transaction signing and contract interaction layer.
+ *
+ * Provides the missing transaction capability to Eliza's wallet system,
+ * which currently only handles key generation and balance fetching.
+ * Used by the registry and drop services for on-chain operations.
+ */
+import * as ethers from "ethers";
+export interface JsonRpcEndpointProbeResult {
+    ok: boolean;
+    reason?: string;
+}
+export declare function normalizeJsonRpcUrl(rpcUrl: string): string;
+export declare function probeJsonRpcEndpoint(rpcUrl: string, timeoutMs?: number): Promise<JsonRpcEndpointProbeResult>;
+export declare class TxService {
+    private readonly provider;
+    private readonly wallet;
+    private readonly rpcUrl;
+    constructor(rpcUrl: string, privateKey: string);
+    /**
+     * Get fresh nonce for the wallet address.
+     * Always fetches from blockchain using a fresh provider to avoid caching issues.
+     * This ensures we always get the correct nonce even after failed transactions.
+     */
+    getFreshNonce(): Promise<number>;
+    get address(): string;
+    getBalance(): Promise<bigint>;
+    getBalanceFormatted(): Promise<string>;
+    getChainId(): Promise<number>;
+    getContract(address: string, abi: ethers.InterfaceAbi): ethers.Contract;
+    getReadOnlyContract(address: string, abi: ethers.InterfaceAbi): ethers.Contract;
+    estimateGas(tx: ethers.TransactionRequest): Promise<bigint>;
+    getFeeData(): Promise<ethers.FeeData>;
+    /**
+     * Wait for a transaction to be mined and return the receipt.
+     * Throws if the transaction fails or times out.
+     */
+    waitForTransaction(txHash: string, confirmations?: number, timeoutMs?: number): Promise<ethers.TransactionReceipt>;
+    /**
+     * Estimate the gas cost in ETH for a contract call.
+     * Useful for showing users how much gas they'll need.
+     */
+    estimateGasCostEth(tx: ethers.TransactionRequest): Promise<string>;
+    /**
+     * Check whether the wallet has enough balance for a given value + estimated gas.
+     */
+    hasEnoughBalance(value: bigint, gasEstimate: bigint): Promise<boolean>;
+    /**
+     * Log a summary of the tx service state for diagnostics.
+     */
+    logStatus(): Promise<void>;
+}
+//# sourceMappingURL=tx-service.d.ts.map

package/api/tx-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tx-service.d.ts","sourceRoot":"","sources":["../../src/api/tx-service.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AAGjC,MAAM,WAAW,0BAA0B;IACzC,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAaD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAsB1D;AAED,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,MAAM,EACd,SAAS,SAAQ,GAChB,OAAO,CAAC,0BAA0B,CAAC,CAoDrC;AAED,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAyB;IAClD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEpB,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM;IAwB9C;;;;OAIG;IACG,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC;IAsBtC,IAAI,OAAO,IAAI,MAAM,CAEpB;IAEK,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;IAI7B,mBAAmB,IAAI,OAAO,CAAC,MAAM,CAAC;IAKtC,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;IAKnC,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,YAAY,GAAG,MAAM,CAAC,QAAQ;IAIvE,mBAAmB,CACjB,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,CAAC,YAAY,GACvB,MAAM,CAAC,QAAQ;IAIZ,WAAW,CAAC,EAAE,EAAE,MAAM,CAAC,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC;IAI3D,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC;IAI3C;;;OAGG;IACG,kBAAkB,CACtB,MAAM,EAAE,MAAM,EACd,aAAa,GAAE,MAAU,EACzB,SAAS,GAAE,MAAgB,GAC1B,OAAO,CAAC,MAAM,CAAC,kBAAkB,CAAC;IAiCrC;;;OAGG;IACG,kBAAkB,CAAC,EAAE,EAAE,MAAM,CAAC,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC;IAQxE;;OAEG;IACG,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAQ5E;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;CASjC"}