@intent-systems/nexus 2026.1.5-3

package/dist/agents/tool-display.js

@@ -0,0 +1,155 @@
+import { redactToolDetail } from "../logging/redact.js";
+import { shortenHomeInString } from "../utils.js";
+import TOOL_DISPLAY_JSON from "./tool-display.json" with { type: "json" };
+const TOOL_DISPLAY_CONFIG = TOOL_DISPLAY_JSON;
+const FALLBACK = TOOL_DISPLAY_CONFIG.fallback ?? { emoji: "🧩" };
+const TOOL_MAP = TOOL_DISPLAY_CONFIG.tools ?? {};
+function normalizeToolName(name) {
+    return (name ?? "tool").trim();
+}
+function defaultTitle(name) {
+    const cleaned = name.replace(/_/g, " ").trim();
+    if (!cleaned)
+        return "Tool";
+    return cleaned
+        .split(/\s+/)
+        .map((part) => part.length <= 2 && part.toUpperCase() === part
+        ? part
+        : `${part.at(0)?.toUpperCase() ?? ""}${part.slice(1)}`)
+        .join(" ");
+}
+function normalizeVerb(value) {
+    const trimmed = value?.trim();
+    if (!trimmed)
+        return undefined;
+    return trimmed.replace(/_/g, " ");
+}
+function coerceDisplayValue(value) {
+    if (value === null || value === undefined)
+        return undefined;
+    if (typeof value === "string") {
+        const trimmed = value.trim();
+        if (!trimmed)
+            return undefined;
+        const firstLine = trimmed.split(/\r?\n/)[0]?.trim() ?? "";
+        if (!firstLine)
+            return undefined;
+        return firstLine.length > 160 ? `${firstLine.slice(0, 157)}…` : firstLine;
+    }
+    if (typeof value === "number" || typeof value === "boolean") {
+        return String(value);
+    }
+    if (Array.isArray(value)) {
+        const values = value
+            .map((item) => coerceDisplayValue(item))
+            .filter((item) => Boolean(item));
+        if (values.length === 0)
+            return undefined;
+        const preview = values.slice(0, 3).join(", ");
+        return values.length > 3 ? `${preview}…` : preview;
+    }
+    return undefined;
+}
+function lookupValueByPath(args, path) {
+    if (!args || typeof args !== "object")
+        return undefined;
+    let current = args;
+    for (const segment of path.split(".")) {
+        if (!segment)
+            return undefined;
+        if (!current || typeof current !== "object")
+            return undefined;
+        const record = current;
+        current = record[segment];
+    }
+    return current;
+}
+function resolveDetailFromKeys(args, keys) {
+    for (const key of keys) {
+        const value = lookupValueByPath(args, key);
+        const display = coerceDisplayValue(value);
+        if (display)
+            return display;
+    }
+    return undefined;
+}
+function resolveReadDetail(args) {
+    if (!args || typeof args !== "object")
+        return undefined;
+    const record = args;
+    const path = typeof record.path === "string" ? record.path : undefined;
+    if (!path)
+        return undefined;
+    const offset = typeof record.offset === "number" ? record.offset : undefined;
+    const limit = typeof record.limit === "number" ? record.limit : undefined;
+    if (offset !== undefined && limit !== undefined) {
+        return `${path}:${offset}-${offset + limit}`;
+    }
+    return path;
+}
+function resolveWriteDetail(args) {
+    if (!args || typeof args !== "object")
+        return undefined;
+    const record = args;
+    const path = typeof record.path === "string" ? record.path : undefined;
+    return path;
+}
+function resolveActionSpec(spec, action) {
+    if (!spec || !action)
+        return undefined;
+    return spec.actions?.[action] ?? undefined;
+}
+export function resolveToolDisplay(params) {
+    const name = normalizeToolName(params.name);
+    const key = name.toLowerCase();
+    const spec = TOOL_MAP[key];
+    const emoji = spec?.emoji ?? FALLBACK.emoji ?? "🧩";
+    const title = spec?.title ?? defaultTitle(name);
+    const label = spec?.label ?? name;
+    const actionRaw = params.args && typeof params.args === "object"
+        ? params.args.action
+        : undefined;
+    const action = typeof actionRaw === "string" ? actionRaw.trim() : undefined;
+    const actionSpec = resolveActionSpec(spec, action);
+    const verb = normalizeVerb(actionSpec?.label ?? action);
+    let detail;
+    if (key === "read")
+        detail = resolveReadDetail(params.args);
+    if (!detail && (key === "write" || key === "edit" || key === "attach")) {
+        detail = resolveWriteDetail(params.args);
+    }
+    const detailKeys = actionSpec?.detailKeys ?? spec?.detailKeys ?? FALLBACK.detailKeys ?? [];
+    if (!detail && detailKeys.length > 0) {
+        detail = resolveDetailFromKeys(params.args, detailKeys);
+    }
+    if (!detail && params.meta) {
+        detail = params.meta;
+    }
+    if (detail) {
+        detail = shortenHomeInString(detail);
+    }
+    return {
+        name,
+        emoji,
+        title,
+        label,
+        verb,
+        detail,
+    };
+}
+export function formatToolDetail(display) {
+    const parts = [];
+    if (display.verb)
+        parts.push(display.verb);
+    if (display.detail)
+        parts.push(redactToolDetail(display.detail));
+    if (parts.length === 0)
+        return undefined;
+    return parts.join(" · ");
+}
+export function formatToolSummary(display) {
+    const detail = formatToolDetail(display);
+    return detail
+        ? `${display.emoji} ${display.label}: ${detail}`
+        : `${display.emoji} ${display.label}`;
+}

package/dist/agents/tool-display.json

@@ -0,0 +1,236 @@
+{
+    "version": 1,
+    "fallback": {
+        "emoji": "🧩",
+        "detailKeys": [
+            "command",
+            "path",
+            "url",
+            "targetUrl",
+            "targetId",
+            "ref",
+            "element",
+            "node",
+            "nodeId",
+            "id",
+            "requestId",
+            "to",
+            "channelId",
+            "guildId",
+            "userId",
+            "name",
+            "query",
+            "pattern",
+            "messageId"
+        ]
+    },
+    "tools": {
+        "bash": {
+            "emoji": "🛠️",
+            "title": "Bash",
+            "detailKeys": ["command"]
+        },
+        "process": {
+            "emoji": "🧰",
+            "title": "Process",
+            "detailKeys": ["sessionId"]
+        },
+        "read": {
+            "emoji": "📖",
+            "title": "Read",
+            "detailKeys": ["path"]
+        },
+        "write": {
+            "emoji": "✍️",
+            "title": "Write",
+            "detailKeys": ["path"]
+        },
+        "edit": {
+            "emoji": "📝",
+            "title": "Edit",
+            "detailKeys": ["path"]
+        },
+        "attach": {
+            "emoji": "📎",
+            "title": "Attach",
+            "detailKeys": ["path", "url", "fileName"]
+        },
+        "browser": {
+            "emoji": "🌐",
+            "title": "Browser",
+            "actions": {
+                "status": { "label": "status" },
+                "start": { "label": "start" },
+                "stop": { "label": "stop" },
+                "tabs": { "label": "tabs" },
+                "open": { "label": "open", "detailKeys": ["targetUrl"] },
+                "focus": { "label": "focus", "detailKeys": ["targetId"] },
+                "close": { "label": "close", "detailKeys": ["targetId"] },
+                "snapshot": {
+                    "label": "snapshot",
+                    "detailKeys": ["targetUrl", "targetId", "ref", "element", "format"]
+                },
+                "screenshot": {
+                    "label": "screenshot",
+                    "detailKeys": ["targetUrl", "targetId", "ref", "element"]
+                },
+                "navigate": {
+                    "label": "navigate",
+                    "detailKeys": ["targetUrl", "targetId"]
+                },
+                "console": { "label": "console", "detailKeys": ["level", "targetId"] },
+                "pdf": { "label": "pdf", "detailKeys": ["targetId"] },
+                "upload": {
+                    "label": "upload",
+                    "detailKeys": ["paths", "ref", "inputRef", "element", "targetId"]
+                },
+                "dialog": {
+                    "label": "dialog",
+                    "detailKeys": ["accept", "promptText", "targetId"]
+                },
+                "act": {
+                    "label": "act",
+                    "detailKeys": ["request.kind", "request.ref", "request.selector", "request.text", "request.value"]
+                }
+            }
+        },
+        "canvas": {
+            "emoji": "🖼️",
+            "title": "Canvas",
+            "actions": {
+                "present": { "label": "present", "detailKeys": ["target", "node", "nodeId"] },
+                "hide": { "label": "hide", "detailKeys": ["node", "nodeId"] },
+                "navigate": { "label": "navigate", "detailKeys": ["url", "node", "nodeId"] },
+                "eval": { "label": "eval", "detailKeys": ["javaScript", "node", "nodeId"] },
+                "snapshot": { "label": "snapshot", "detailKeys": ["format", "node", "nodeId"] },
+                "a2ui_push": { "label": "A2UI push", "detailKeys": ["jsonlPath", "node", "nodeId"] },
+                "a2ui_reset": { "label": "A2UI reset", "detailKeys": ["node", "nodeId"] }
+            }
+        },
+        "nodes": {
+            "emoji": "📱",
+            "title": "Nodes",
+            "actions": {
+                "status": { "label": "status" },
+                "describe": { "label": "describe", "detailKeys": ["node", "nodeId"] },
+                "pending": { "label": "pending" },
+                "approve": { "label": "approve", "detailKeys": ["requestId"] },
+                "reject": { "label": "reject", "detailKeys": ["requestId"] },
+                "notify": { "label": "notify", "detailKeys": ["node", "nodeId", "title", "body"] },
+                "camera_snap": { "label": "camera snap", "detailKeys": ["node", "nodeId", "facing", "deviceId"] },
+                "camera_list": { "label": "camera list", "detailKeys": ["node", "nodeId"] },
+                "camera_clip": { "label": "camera clip", "detailKeys": ["node", "nodeId", "facing", "duration", "durationMs"] },
+                "screen_record": {
+                    "label": "screen record",
+                    "detailKeys": ["node", "nodeId", "duration", "durationMs", "fps", "screenIndex"]
+                }
+            }
+        },
+        "cron": {
+            "emoji": "⏰",
+            "title": "Cron",
+            "actions": {
+                "status": { "label": "status" },
+                "list": { "label": "list" },
+                "add": {
+                    "label": "add",
+                    "detailKeys": ["job.name", "job.id", "job.schedule", "job.cron"]
+                },
+                "update": { "label": "update", "detailKeys": ["id"] },
+                "remove": { "label": "remove", "detailKeys": ["id"] },
+                "run": { "label": "run", "detailKeys": ["id"] },
+                "runs": { "label": "runs", "detailKeys": ["id"] },
+                "wake": { "label": "wake", "detailKeys": ["text", "mode"] }
+            }
+        },
+        "gateway": {
+            "emoji": "🔌",
+            "title": "Gateway",
+            "actions": {
+                "restart": { "label": "restart", "detailKeys": ["reason", "delayMs"] }
+            }
+        },
+        "sessions_list": {
+            "emoji": "🗂️",
+            "title": "Sessions",
+            "detailKeys": ["kinds", "limit", "activeMinutes", "messageLimit"]
+        },
+        "sessions_history": {
+            "emoji": "🧾",
+            "title": "Session History",
+            "detailKeys": ["sessionKey", "limit"]
+        },
+        "sessions_send": {
+            "emoji": "📨",
+            "title": "Session Send",
+            "detailKeys": ["sessionKey", "timeoutSeconds"]
+        },
+        "sessions_spawn": {
+            "emoji": "🧑‍🔧",
+            "title": "Sub-agent",
+            "detailKeys": ["label", "timeoutSeconds", "cleanup"]
+        },
+        "whatsapp_login": {
+            "emoji": "🟢",
+            "title": "WhatsApp Login",
+            "actions": {
+                "start": { "label": "start" },
+                "wait": { "label": "wait" }
+            }
+        },
+        "discord": {
+            "emoji": "💬",
+            "title": "Discord",
+            "actions": {
+                "react": { "label": "react", "detailKeys": ["channelId", "messageId", "emoji"] },
+                "reactions": { "label": "reactions", "detailKeys": ["channelId", "messageId"] },
+                "sticker": { "label": "sticker", "detailKeys": ["to", "stickerIds"] },
+                "poll": { "label": "poll", "detailKeys": ["question", "to"] },
+                "permissions": { "label": "permissions", "detailKeys": ["channelId"] },
+                "readMessages": { "label": "read messages", "detailKeys": ["channelId", "limit"] },
+                "sendMessage": { "label": "send", "detailKeys": ["to", "content"] },
+                "editMessage": { "label": "edit", "detailKeys": ["channelId", "messageId"] },
+                "deleteMessage": { "label": "delete", "detailKeys": ["channelId", "messageId"] },
+                "threadCreate": { "label": "thread create", "detailKeys": ["channelId", "name"] },
+                "threadList": { "label": "thread list", "detailKeys": ["guildId", "channelId"] },
+                "threadReply": { "label": "thread reply", "detailKeys": ["channelId", "content"] },
+                "pinMessage": { "label": "pin", "detailKeys": ["channelId", "messageId"] },
+                "unpinMessage": { "label": "unpin", "detailKeys": ["channelId", "messageId"] },
+                "listPins": { "label": "list pins", "detailKeys": ["channelId"] },
+                "searchMessages": { "label": "search", "detailKeys": ["guildId", "content"] },
+                "memberInfo": { "label": "member", "detailKeys": ["guildId", "userId"] },
+                "roleInfo": { "label": "roles", "detailKeys": ["guildId"] },
+                "emojiList": { "label": "emoji list", "detailKeys": ["guildId"] },
+                "emojiUpload": { "label": "emoji upload", "detailKeys": ["guildId", "name"] },
+                "stickerUpload": { "label": "sticker upload", "detailKeys": ["guildId", "name"] },
+                "roleAdd": { "label": "role add", "detailKeys": ["guildId", "userId", "roleId"] },
+                "roleRemove": { "label": "role remove", "detailKeys": ["guildId", "userId", "roleId"] },
+                "channelInfo": { "label": "channel", "detailKeys": ["channelId"] },
+                "channelList": { "label": "channels", "detailKeys": ["guildId"] },
+                "voiceStatus": { "label": "voice", "detailKeys": ["guildId", "userId"] },
+                "eventList": { "label": "events", "detailKeys": ["guildId"] },
+                "eventCreate": { "label": "event create", "detailKeys": ["guildId", "name"] },
+                "timeout": { "label": "timeout", "detailKeys": ["guildId", "userId"] },
+                "kick": { "label": "kick", "detailKeys": ["guildId", "userId"] },
+                "ban": { "label": "ban", "detailKeys": ["guildId", "userId"] }
+            }
+        },
+        "slack": {
+            "emoji": "💬",
+            "title": "Slack",
+            "actions": {
+                "react": { "label": "react", "detailKeys": ["channelId", "messageId", "emoji"] },
+                "reactions": { "label": "reactions", "detailKeys": ["channelId", "messageId"] },
+                "sendMessage": { "label": "send", "detailKeys": ["to", "content"] },
+                "editMessage": { "label": "edit", "detailKeys": ["channelId", "messageId"] },
+                "deleteMessage": { "label": "delete", "detailKeys": ["channelId", "messageId"] },
+                "readMessages": { "label": "read messages", "detailKeys": ["channelId", "limit"] },
+                "pinMessage": { "label": "pin", "detailKeys": ["channelId", "messageId"] },
+                "unpinMessage": { "label": "unpin", "detailKeys": ["channelId", "messageId"] },
+                "listPins": { "label": "list pins", "detailKeys": ["channelId"] },
+                "memberInfo": { "label": "member", "detailKeys": ["userId"] },
+                "emojiList": { "label": "emoji list" }
+            }
+        }
+    }
+}

package/dist/agents/tool-images.js

@@ -0,0 +1,138 @@
+import { getImageMetadata, resizeToJpeg } from "../media/image-ops.js";
+// Anthropic Messages API limitations (observed in Nexus sessions):
+// - Images over ~2000px per side can fail in multi-image requests.
+// - Images over 5MB are rejected by the API.
+//
+// To keep sessions resilient (and avoid "silent" WhatsApp non-replies), we auto-downscale
+// and recompress base64 image blocks when they exceed these limits.
+const MAX_IMAGE_DIMENSION_PX = 2000;
+const MAX_IMAGE_BYTES = 5 * 1024 * 1024;
+function isImageBlock(block) {
+    if (!block || typeof block !== "object")
+        return false;
+    const rec = block;
+    return (rec.type === "image" &&
+        typeof rec.data === "string" &&
+        typeof rec.mimeType === "string");
+}
+function isTextBlock(block) {
+    if (!block || typeof block !== "object")
+        return false;
+    const rec = block;
+    return rec.type === "text" && typeof rec.text === "string";
+}
+function inferMimeTypeFromBase64(base64) {
+    const trimmed = base64.trim();
+    if (!trimmed)
+        return undefined;
+    if (trimmed.startsWith("/9j/"))
+        return "image/jpeg";
+    if (trimmed.startsWith("iVBOR"))
+        return "image/png";
+    if (trimmed.startsWith("R0lGOD"))
+        return "image/gif";
+    return undefined;
+}
+async function resizeImageBase64IfNeeded(params) {
+    const buf = Buffer.from(params.base64, "base64");
+    const meta = await getImageMetadata(buf);
+    const width = meta?.width;
+    const height = meta?.height;
+    const overBytes = buf.byteLength > params.maxBytes;
+    const maxDim = Math.max(width ?? 0, height ?? 0);
+    if (typeof width !== "number" || typeof height !== "number") {
+        if (!overBytes) {
+            return {
+                base64: params.base64,
+                mimeType: params.mimeType,
+                resized: false,
+            };
+        }
+    }
+    else if (!overBytes &&
+        width <= params.maxDimensionPx &&
+        height <= params.maxDimensionPx) {
+        return { base64: params.base64, mimeType: params.mimeType, resized: false };
+    }
+    const qualities = [85, 75, 65, 55, 45, 35];
+    const sideStart = maxDim > 0
+        ? Math.min(params.maxDimensionPx, maxDim)
+        : params.maxDimensionPx;
+    const sideGrid = [sideStart, 1800, 1600, 1400, 1200, 1000, 800]
+        .map((v) => Math.min(params.maxDimensionPx, v))
+        .filter((v, i, arr) => v > 0 && arr.indexOf(v) === i)
+        .sort((a, b) => b - a);
+    let smallest = null;
+    for (const side of sideGrid) {
+        for (const quality of qualities) {
+            const out = await resizeToJpeg({
+                buffer: buf,
+                maxSide: side,
+                quality,
+                withoutEnlargement: true,
+            });
+            if (!smallest || out.byteLength < smallest.size) {
+                smallest = { buffer: out, size: out.byteLength };
+            }
+            if (out.byteLength <= params.maxBytes) {
+                return {
+                    base64: out.toString("base64"),
+                    mimeType: "image/jpeg",
+                    resized: true,
+                };
+            }
+        }
+    }
+    const best = smallest?.buffer ?? buf;
+    const maxMb = (params.maxBytes / (1024 * 1024)).toFixed(0);
+    const gotMb = (best.byteLength / (1024 * 1024)).toFixed(2);
+    throw new Error(`Image could not be reduced below ${maxMb}MB (got ${gotMb}MB)`);
+}
+export async function sanitizeContentBlocksImages(blocks, label, opts = {}) {
+    const maxDimensionPx = Math.max(opts.maxDimensionPx ?? MAX_IMAGE_DIMENSION_PX, 1);
+    const maxBytes = Math.max(opts.maxBytes ?? MAX_IMAGE_BYTES, 1);
+    const out = [];
+    for (const block of blocks) {
+        if (!isImageBlock(block)) {
+            out.push(block);
+            continue;
+        }
+        const data = block.data.trim();
+        if (!data) {
+            out.push({
+                type: "text",
+                text: `[${label}] omitted empty image payload`,
+            });
+            continue;
+        }
+        try {
+            const inferredMimeType = inferMimeTypeFromBase64(data);
+            const mimeType = inferredMimeType ?? block.mimeType;
+            const resized = await resizeImageBase64IfNeeded({
+                base64: data,
+                mimeType,
+                maxDimensionPx,
+                maxBytes,
+            });
+            out.push({
+                ...block,
+                data: resized.base64,
+                mimeType: resized.resized ? resized.mimeType : mimeType,
+            });
+        }
+        catch (err) {
+            out.push({
+                type: "text",
+                text: `[${label}] omitted image payload: ${String(err)}`,
+            });
+        }
+    }
+    return out;
+}
+export async function sanitizeToolResultImages(result, label, opts = {}) {
+    const content = Array.isArray(result.content) ? result.content : [];
+    if (!content.some((b) => isImageBlock(b) || isTextBlock(b)))
+        return result;
+    const next = await sanitizeContentBlocksImages(content, label, opts);
+    return { ...result, content: next };
+}

package/dist/agents/tool-policy.js

@@ -0,0 +1,87 @@
+const TOOL_NAME_ALIASES = {
+    bash: "exec",
+    "apply-patch": "apply_patch",
+};
+export const TOOL_GROUPS = {
+    // NOTE: Keep canonical (lowercase) tool names here.
+    "group:memory": ["memory_search", "memory_get"],
+    // Basic workspace/file tools
+    "group:fs": ["read", "write", "edit", "apply_patch"],
+    // Host/runtime execution tools
+    "group:runtime": ["exec", "process"],
+    // Session management tools
+    "group:sessions": ["sessions_list", "sessions_history", "sessions_send", "sessions_spawn"],
+    // UI helpers
+    "group:ui": ["browser", "canvas"],
+    // Automation + infra
+    "group:automation": ["cron", "gateway"],
+    // Messaging surface (provider tools)
+    "group:messaging": ["discord", "slack"],
+    // Nodes + device tools
+    "group:nodes": ["nodes"],
+    // All built-in Nexus tools (excludes provider-specific tools).
+    "group:nexus": [
+        "browser",
+        "canvas",
+        "nodes",
+        "cron",
+        "discord",
+        "slack",
+        "gateway",
+        "sessions_list",
+        "sessions_history",
+        "sessions_send",
+        "sessions_spawn",
+        "memory_search",
+        "memory_get",
+        "image",
+        "whatsapp_login",
+    ],
+};
+const TOOL_PROFILES = {
+    minimal: {
+        allow: ["sessions_list"],
+    },
+    coding: {
+        allow: ["group:fs", "group:runtime", "group:sessions", "group:memory", "image"],
+    },
+    messaging: {
+        allow: ["group:messaging", "sessions_list", "sessions_history", "sessions_send"],
+    },
+    full: {},
+};
+export function normalizeToolName(name) {
+    const normalized = name.trim().toLowerCase();
+    return TOOL_NAME_ALIASES[normalized] ?? normalized;
+}
+export function normalizeToolList(list) {
+    if (!list)
+        return [];
+    return list.map(normalizeToolName).filter(Boolean);
+}
+export function expandToolGroups(list) {
+    const normalized = normalizeToolList(list);
+    const expanded = [];
+    for (const value of normalized) {
+        const group = TOOL_GROUPS[value];
+        if (group) {
+            expanded.push(...group);
+            continue;
+        }
+        expanded.push(value);
+    }
+    return Array.from(new Set(expanded));
+}
+export function resolveToolProfilePolicy(profile) {
+    if (!profile)
+        return undefined;
+    const resolved = TOOL_PROFILES[profile];
+    if (!resolved)
+        return undefined;
+    if (!resolved.allow && !resolved.deny)
+        return undefined;
+    return {
+        allow: resolved.allow ? [...resolved.allow] : undefined,
+        deny: resolved.deny ? [...resolved.deny] : undefined,
+    };
+}

package/dist/agents/tools/agent-step.js

@@ -0,0 +1,41 @@
+import crypto from "node:crypto";
+import { callGateway } from "../../gateway/call.js";
+import { extractAssistantText, stripToolMessages } from "./sessions-helpers.js";
+export async function readLatestAssistantReply(params) {
+    const history = (await callGateway({
+        method: "chat.history",
+        params: { sessionKey: params.sessionKey, limit: params.limit ?? 50 },
+    }));
+    const filtered = stripToolMessages(Array.isArray(history?.messages) ? history.messages : []);
+    const last = filtered.length > 0 ? filtered[filtered.length - 1] : undefined;
+    return last ? extractAssistantText(last) : undefined;
+}
+export async function runAgentStep(params) {
+    const stepIdem = crypto.randomUUID();
+    const response = (await callGateway({
+        method: "agent",
+        params: {
+            message: params.message,
+            sessionKey: params.sessionKey,
+            idempotencyKey: stepIdem,
+            deliver: false,
+            lane: params.lane ?? "nested",
+            extraSystemPrompt: params.extraSystemPrompt,
+        },
+        timeoutMs: 10_000,
+    }));
+    const stepRunId = typeof response?.runId === "string" && response.runId ? response.runId : "";
+    const resolvedRunId = stepRunId || stepIdem;
+    const stepWaitMs = Math.min(params.timeoutMs, 60_000);
+    const wait = (await callGateway({
+        method: "agent.wait",
+        params: {
+            runId: resolvedRunId,
+            timeoutMs: stepWaitMs,
+        },
+        timeoutMs: stepWaitMs + 2000,
+    }));
+    if (wait?.status !== "ok")
+        return undefined;
+    return await readLatestAssistantReply({ sessionKey: params.sessionKey });
+}