@poolzin/pool-bot 2026.1.39 → 2026.2.1

package/dist/agents/system-prompt.js

@@ -23,11 +23,18 @@ function buildMemorySection(params) {
     if (!params.availableTools.has("memory_search") && !params.availableTools.has("memory_get")) {
         return [];
     }
-    return [
+    const lines = [
         "## Memory Recall",
         "Before answering anything about prior work, decisions, dates, people, preferences, or todos: run memory_search on MEMORY.md + memory/*.md; then use memory_get to pull only the needed lines. If low confidence after search, say you checked.",
-        "",
     ];
+    if (params.citationsMode === "off") {
+        lines.push("Citations are disabled: do not mention file paths or line numbers in replies unless the user explicitly asks.");
+    }
+    else {
+        lines.push("Citations: include Source: <path#line> when it helps the user verify memory snippets.");
+    }
+    lines.push("");
+    return lines;
 }
 function buildUserIdentitySection(ownerLine, isMinimal) {
     if (!ownerLine || isMinimal)
@@ -46,7 +53,7 @@ function buildReplyTagsSection(isMinimal) {
         "## Reply Tags",
         "To request a native reply/quote on supported surfaces, include one tag in your reply:",
         "- [[reply_to_current]] replies to the triggering message.",
-        "- [[reply_to:<id>]] replies to a specific message id when you have it.",
+        "- Prefer [[reply_to_current]]. Use [[reply_to:<id>]] only when an id was explicitly provided (e.g. by the user or a tool).",
         "Whitespace inside the tag is allowed (e.g. [[ reply_to_current ]] / [[ reply_to: 123 ]]).",
         "Tags are stripped before sending; support depends on the current channel config.",
         "",
@@ -228,12 +235,23 @@ export function buildAgentSystemPrompt(params) {
     const messageChannelOptions = listDeliverableMessageChannels().join("|");
     const promptMode = params.promptMode ?? "full";
     const isMinimal = promptMode === "minimal" || promptMode === "none";
+    const safetySection = [
+        "## Safety",
+        "You have no independent goals: do not pursue self-preservation, replication, resource acquisition, or power-seeking; avoid long-term plans beyond the user's request.",
+        "Prioritize safety and human oversight over completion; if instructions conflict, pause and ask; comply with stop/pause/audit requests and never bypass safeguards. (Inspired by Anthropic's constitution.)",
+        "Do not manipulate or persuade anyone to expand access or disable safeguards. Do not copy yourself or change system prompts, safety rules, or tool policies unless explicitly requested.",
+        "",
+    ];
     const skillsSection = buildSkillsSection({
         skillsPrompt,
         isMinimal,
         readToolName,
     });
-    const memorySection = buildMemorySection({ isMinimal, availableTools });
+    const memorySection = buildMemorySection({
+        isMinimal,
+        availableTools,
+        citationsMode: params.memoryCitationsMode,
+    });
     const docsSection = buildDocsSection({
         docsPath: params.docsPath,
         isMinimal,
@@ -267,6 +285,7 @@ export function buildAgentSystemPrompt(params) {
                 "- sessions_list: list sessions",
                 "- sessions_history: fetch session history",
                 "- sessions_send: send to another session",
+                '- session_status: show usage/time/model state and answer "what model are we using?"',
             ].join("\n"),
         "TOOLS.md does not control tool availability; it is user guidance for how to use external tools.",
         "If a task is more complex or takes longer, spawn a sub-agent. It will do the work for you and ping you when it's done. You can always check up on it.",
@@ -277,6 +296,7 @@ export function buildAgentSystemPrompt(params) {
         "Keep narration brief and value-dense; avoid repeating obvious steps.",
         "Use plain human language for narration unless in a technical context.",
         "",
+        ...safetySection,
         "## Pool Bot CLI Quick Reference",
         "Pool Bot is controlled via subcommands. Do not invent commands.",
         "To manage the Gateway daemon service (start/stop/restart):",
@@ -311,6 +331,9 @@ export function buildAgentSystemPrompt(params) {
             ? params.modelAliasLines.join("\n")
             : "",
         params.modelAliasLines && params.modelAliasLines.length > 0 && !isMinimal ? "" : "",
+        userTimezone
+            ? "If you need the current date, time, or day of week, run session_status (📊 session_status)."
+            : "",
         "## Workspace",
         `Your working directory is: ${params.workspaceDir}`,
         "Treat this directory as the single global workspace for file operations unless explicitly instructed otherwise.",
@@ -445,6 +468,7 @@ export function buildRuntimeLine(runtimeInfo, runtimeChannel, runtimeCapabilitie
         runtimeInfo?.node ? `node=${runtimeInfo.node}` : "",
         runtimeInfo?.model ? `model=${runtimeInfo.model}` : "",
         runtimeInfo?.defaultModel ? `default_model=${runtimeInfo.defaultModel}` : "",
+        runtimeInfo?.shell ? `shell=${runtimeInfo.shell}` : "",
         runtimeChannel ? `channel=${runtimeChannel}` : "",
         runtimeChannel
             ? `capabilities=${runtimeCapabilities.length > 0 ? runtimeCapabilities.join(",") : "none"}`

package/dist/agents/together-models.js

@@ -0,0 +1,127 @@
+export const TOGETHER_BASE_URL = "https://api.together.xyz/v1";
+export const TOGETHER_MODEL_CATALOG = [
+    {
+        id: "zai-org/GLM-4.7",
+        name: "GLM 4.7 Fp8",
+        reasoning: false,
+        input: ["text"],
+        contextWindow: 202752,
+        maxTokens: 8192,
+        cost: {
+            input: 0.45,
+            output: 2.0,
+            cacheRead: 0.45,
+            cacheWrite: 2.0,
+        },
+    },
+    {
+        id: "moonshotai/Kimi-K2.5",
+        name: "Kimi K2.5",
+        reasoning: true,
+        input: ["text", "image"],
+        cost: {
+            input: 0.5,
+            output: 2.8,
+            cacheRead: 0.5,
+            cacheWrite: 2.8,
+        },
+        contextWindow: 262144,
+        maxTokens: 32768,
+    },
+    {
+        id: "meta-llama/Llama-3.3-70B-Instruct-Turbo",
+        name: "Llama 3.3 70B Instruct Turbo",
+        reasoning: false,
+        input: ["text"],
+        contextWindow: 131072,
+        maxTokens: 8192,
+        cost: {
+            input: 0.88,
+            output: 0.88,
+            cacheRead: 0.88,
+            cacheWrite: 0.88,
+        },
+    },
+    {
+        id: "meta-llama/Llama-4-Scout-17B-16E-Instruct",
+        name: "Llama 4 Scout 17B 16E Instruct",
+        reasoning: false,
+        input: ["text", "image"],
+        contextWindow: 10000000,
+        maxTokens: 32768,
+        cost: {
+            input: 0.18,
+            output: 0.59,
+            cacheRead: 0.18,
+            cacheWrite: 0.18,
+        },
+    },
+    {
+        id: "meta-llama/Llama-4-Maverick-17B-128E-Instruct-FP8",
+        name: "Llama 4 Maverick 17B 128E Instruct FP8",
+        reasoning: false,
+        input: ["text", "image"],
+        contextWindow: 20000000,
+        maxTokens: 32768,
+        cost: {
+            input: 0.27,
+            output: 0.85,
+            cacheRead: 0.27,
+            cacheWrite: 0.27,
+        },
+    },
+    {
+        id: "deepseek-ai/DeepSeek-V3.1",
+        name: "DeepSeek V3.1",
+        reasoning: false,
+        input: ["text"],
+        contextWindow: 131072,
+        maxTokens: 8192,
+        cost: {
+            input: 0.6,
+            output: 1.25,
+            cacheRead: 0.6,
+            cacheWrite: 0.6,
+        },
+    },
+    {
+        id: "deepseek-ai/DeepSeek-R1",
+        name: "DeepSeek R1",
+        reasoning: true,
+        input: ["text"],
+        contextWindow: 131072,
+        maxTokens: 8192,
+        cost: {
+            input: 3.0,
+            output: 7.0,
+            cacheRead: 3.0,
+            cacheWrite: 3.0,
+        },
+    },
+    {
+        id: "moonshotai/Kimi-K2-Instruct-0905",
+        name: "Kimi K2-Instruct 0905",
+        reasoning: false,
+        input: ["text"],
+        contextWindow: 262144,
+        maxTokens: 8192,
+        cost: {
+            input: 1.0,
+            output: 3.0,
+            cacheRead: 1.0,
+            cacheWrite: 3.0,
+        },
+    },
+];
+export function buildTogetherModelDefinition(model) {
+    return {
+        id: model.id,
+        name: model.name,
+        api: "openai-completions",
+        reasoning: model.reasoning,
+        input: model.input,
+        cost: model.cost,
+        contextWindow: model.contextWindow,
+        maxTokens: model.maxTokens,
+    };
+}

package/dist/agents/tool-images.js

@@ -1,6 +1,6 @@
 import { createSubsystemLogger } from "../logging/subsystem.js";
 import { getImageMetadata, resizeToJpeg } from "../media/image-ops.js";
-// Anthropic Messages API limitations (observed in Moltbot sessions):
+// Anthropic Messages API limitations (observed in Poolbot sessions):
 // - Images over ~2000px per side can fail in multi-image requests.
 // - Images over 5MB are rejected by the API.
 //

package/dist/agents/tool-policy.conformance.js

@@ -0,0 +1,14 @@
+/**
+ * Conformance snapshot for tool policy.
+ *
+ * Security note:
+ * - This is static, build-time information (no runtime I/O, no network exposure).
+ * - Intended for CI/tools to detect drift between the implementation policy and
+ *   the formal models/extractors.
+ */
+import { TOOL_GROUPS } from "./tool-policy.js";
+// Tool name aliases are intentionally not exported from tool-policy today.
+// Keep the conformance snapshot focused on exported policy constants.
+export const TOOL_POLICY_CONFORMANCE = {
+    toolGroups: TOOL_GROUPS,
+};

package/dist/agents/tool-policy.js

@@ -26,7 +26,7 @@ export const TOOL_GROUPS = {
     "group:messaging": ["message"],
     // Nodes + device tools
     "group:nodes": ["nodes"],
-    // All Moltbot native tools (excludes provider plugins).
+    // All Poolbot native tools (excludes provider plugins).
     "group:poolbot": [
         "browser",
         "canvas",
@@ -47,6 +47,7 @@ export const TOOL_GROUPS = {
         "image",
     ],
 };
+const OWNER_ONLY_TOOL_NAMES = new Set(["whatsapp_login"]);
 const TOOL_PROFILES = {
     minimal: {
         allow: ["session_status"],
@@ -69,6 +70,29 @@ export function normalizeToolName(name) {
     const normalized = name.trim().toLowerCase();
     return TOOL_NAME_ALIASES[normalized] ?? normalized;
 }
+export function isOwnerOnlyToolName(name) {
+    return OWNER_ONLY_TOOL_NAMES.has(normalizeToolName(name));
+}
+export function applyOwnerOnlyToolPolicy(tools, senderIsOwner) {
+    const withGuard = tools.map((tool) => {
+        if (!isOwnerOnlyToolName(tool.name)) {
+            return tool;
+        }
+        if (senderIsOwner || !tool.execute) {
+            return tool;
+        }
+        return {
+            ...tool,
+            execute: async () => {
+                throw new Error("Tool restricted to owner senders.");
+            },
+        };
+    });
+    if (senderIsOwner) {
+        return withGuard;
+    }
+    return withGuard.filter((tool) => !isOwnerOnlyToolName(tool.name));
+}
 export function normalizeToolList(list) {
     if (!list)
         return [];

package/dist/agents/tools/browser-tool.js

@@ -143,11 +143,11 @@ export function createBrowserTool(opts) {
         label: "Browser",
         name: "browser",
         description: [
-            "Control the browser via Moltbot's browser control server (status/start/stop/profiles/tabs/open/snapshot/screenshot/actions).",
+            "Control the browser via Poolbot's browser control server (status/start/stop/profiles/tabs/open/snapshot/screenshot/actions).",
             'Profiles: use profile="chrome" for Chrome extension relay takeover (your existing Chrome tabs). Use profile="clawd" for the isolated clawd-managed browser.',
             'If the user mentions the Chrome extension / Browser Relay / toolbar button / “attach tab”, ALWAYS use profile="chrome" (do not ask which profile).',
             'When a node-hosted browser proxy is available, the tool may auto-route to it. Pin a node with node=<id|name> or target="node".',
-            "Chrome extension relay needs an attached tab: user must click the Moltbot Browser Relay toolbar icon on the tab (badge ON). If no tab is connected, ask them to attach it.",
+            "Chrome extension relay needs an attached tab: user must click the Poolbot Browser Relay toolbar icon on the tab (badge ON). If no tab is connected, ask them to attach it.",
             "When using refs from snapshot (e.g. e12), keep the same tab: prefer passing targetId from the snapshot response into subsequent actions (act/click/type/etc).",
             'For stable, self-resolving refs across calls, use snapshot with refs="aria" (Playwright aria-ref ids). Default refs="role" are role+name-based.',
             "Use snapshot+act for UI automation. Avoid act:wait by default; use only in exceptional cases when no reliable UI state exists.",
@@ -581,7 +581,7 @@ export function createBrowserTool(opts) {
                                 })).tabs ?? [])
                                 : await browserTabs(baseUrl, { profile }).catch(() => []);
                             if (!tabs.length) {
-                                throw new Error("No Chrome tabs are attached via the Moltbot Browser Relay extension. Click the toolbar icon on the tab you want to control (badge ON), then retry.");
+                                throw new Error("No Chrome tabs are attached via the Poolbot Browser Relay extension. Click the toolbar icon on the tab you want to control (badge ON), then retry.");
                             }
                             throw new Error(`Chrome tab not found (stale targetId?). Run action=tabs profile="chrome" and use one of the returned targetIds.`);
                         }

package/dist/agents/tools/cron-tool.js

@@ -1,9 +1,10 @@
 import { Type } from "@sinclair/typebox";
-import { normalizeCronJobCreate, normalizeCronJobPatch } from "../../cron/normalize.js";
 import { loadConfig } from "../../config/config.js";
-import { truncateUtf16Safe } from "../../utils.js";
-import { optionalStringEnum, stringEnum } from "../schema/typebox.js";
+import { normalizeCronJobCreate, normalizeCronJobPatch } from "../../cron/normalize.js";
+import { parseAgentSessionKey } from "../../sessions/session-key-utils.js";
+import { isRecord, truncateUtf16Safe } from "../../utils.js";
 import { resolveSessionAgentId } from "../agent-scope.js";
+import { optionalStringEnum, stringEnum } from "../schema/typebox.js";
 import { jsonResult, readStringParam } from "./common.js";
 import { callGatewayTool } from "./gateway.js";
 import { resolveInternalSessionKey, resolveMainSessionAlias } from "./sessions-helpers.js";
@@ -13,6 +14,7 @@ import { resolveInternalSessionKey, resolveMainSessionAlias } from "./sessions-h
 // accept "any object" here and validate at runtime.
 const CRON_ACTIONS = ["status", "list", "add", "update", "remove", "run", "runs", "wake"];
 const CRON_WAKE_MODES = ["now", "next-heartbeat"];
+const CRON_RUN_MODES = ["due", "force"];
 const REMINDER_CONTEXT_MESSAGES_MAX = 10;
 const REMINDER_CONTEXT_PER_MESSAGE_MAX = 220;
 const REMINDER_CONTEXT_TOTAL_MAX = 700;
@@ -30,17 +32,20 @@ const CronToolSchema = Type.Object({
     patch: Type.Optional(Type.Object({}, { additionalProperties: true })),
     text: Type.Optional(Type.String()),
     mode: optionalStringEnum(CRON_WAKE_MODES),
+    runMode: optionalStringEnum(CRON_RUN_MODES),
     contextMessages: Type.Optional(Type.Number({ minimum: 0, maximum: REMINDER_CONTEXT_MESSAGES_MAX })),
 });
 function stripExistingContext(text) {
     const index = text.indexOf(REMINDER_CONTEXT_MARKER);
-    if (index === -1)
+    if (index === -1) {
         return text;
+    }
     return text.slice(0, index).trim();
 }
 function truncateText(input, maxLen) {
-    if (input.length <= maxLen)
+    if (input.length <= maxLen) {
         return input;
+    }
     const truncated = truncateUtf16Safe(input, Math.max(0, maxLen - 3)).trimEnd();
     return `${truncated}...`;
 }
@@ -49,21 +54,25 @@ function normalizeContextText(raw) {
 }
 function extractMessageText(message) {
     const role = typeof message.role === "string" ? message.role : "";
-    if (role !== "user" && role !== "assistant")
+    if (role !== "user" && role !== "assistant") {
         return null;
+    }
     const content = message.content;
     if (typeof content === "string") {
         const normalized = normalizeContextText(content);
         return normalized ? { role, text: normalized } : null;
     }
-    if (!Array.isArray(content))
+    if (!Array.isArray(content)) {
         return null;
+    }
     const chunks = [];
     for (const block of content) {
-        if (!block || typeof block !== "object")
+        if (!block || typeof block !== "object") {
             continue;
-        if (block.type !== "text")
+        }
+        if (block.type !== "text") {
             continue;
+        }
         const text = block.text;
         if (typeof text === "string" && text.trim()) {
             chunks.push(text);
@@ -74,26 +83,29 @@ function extractMessageText(message) {
 }
 async function buildReminderContextLines(params) {
     const maxMessages = Math.min(REMINDER_CONTEXT_MESSAGES_MAX, Math.max(0, Math.floor(params.contextMessages)));
-    if (maxMessages <= 0)
+    if (maxMessages <= 0) {
         return [];
+    }
     const sessionKey = params.agentSessionKey?.trim();
-    if (!sessionKey)
+    if (!sessionKey) {
         return [];
+    }
     const cfg = loadConfig();
     const { mainKey, alias } = resolveMainSessionAlias(cfg);
     const resolvedKey = resolveInternalSessionKey({ key: sessionKey, alias, mainKey });
     try {
-        const res = (await callGatewayTool("chat.history", params.gatewayOpts, {
+        const res = await callGatewayTool("chat.history", params.gatewayOpts, {
             sessionKey: resolvedKey,
             limit: maxMessages,
-        }));
+        });
         const messages = Array.isArray(res?.messages) ? res.messages : [];
         const parsed = messages
             .map((msg) => extractMessageText(msg))
             .filter((msg) => Boolean(msg));
         const recent = parsed.slice(-maxMessages);
-        if (recent.length === 0)
+        if (recent.length === 0) {
             return [];
+        }
         const lines = [];
         let total = 0;
         for (const entry of recent) {
@@ -101,8 +113,9 @@ async function buildReminderContextLines(params) {
             const text = truncateText(entry.text, REMINDER_CONTEXT_PER_MESSAGE_MAX);
             const line = `- ${label}: ${text}`;
             total += line.length;
-            if (total > REMINDER_CONTEXT_TOTAL_MAX)
+            if (total > REMINDER_CONTEXT_TOTAL_MAX) {
                 break;
+            }
             lines.push(line);
         }
         return lines;
@@ -111,6 +124,62 @@ async function buildReminderContextLines(params) {
         return [];
     }
 }
+function stripThreadSuffixFromSessionKey(sessionKey) {
+    const normalized = sessionKey.toLowerCase();
+    const idx = normalized.lastIndexOf(":thread:");
+    if (idx <= 0) {
+        return sessionKey;
+    }
+    const parent = sessionKey.slice(0, idx).trim();
+    return parent ? parent : sessionKey;
+}
+function inferDeliveryFromSessionKey(agentSessionKey) {
+    const rawSessionKey = agentSessionKey?.trim();
+    if (!rawSessionKey) {
+        return null;
+    }
+    const parsed = parseAgentSessionKey(stripThreadSuffixFromSessionKey(rawSessionKey));
+    if (!parsed || !parsed.rest) {
+        return null;
+    }
+    const parts = parsed.rest.split(":").filter(Boolean);
+    if (parts.length === 0) {
+        return null;
+    }
+    const head = parts[0]?.trim().toLowerCase();
+    if (!head || head === "main" || head === "subagent" || head === "acp") {
+        return null;
+    }
+    // buildAgentPeerSessionKey encodes peers as:
+    // - direct:<peerId>
+    // - <channel>:direct:<peerId>
+    // - <channel>:<accountId>:direct:<peerId>
+    // - <channel>:group:<peerId>
+    // - <channel>:channel:<peerId>
+    // Note: legacy keys may use "dm" instead of "direct".
+    // Threaded sessions append :thread:<id>, which we strip so delivery targets the parent peer.
+    // NOTE: Telegram forum topics encode as <chatId>:topic:<topicId> and should be preserved.
+    const markerIndex = parts.findIndex((part) => part === "direct" || part === "dm" || part === "group" || part === "channel");
+    if (markerIndex === -1) {
+        return null;
+    }
+    const peerId = parts
+        .slice(markerIndex + 1)
+        .join(":")
+        .trim();
+    if (!peerId) {
+        return null;
+    }
+    let channel;
+    if (markerIndex >= 1) {
+        channel = parts[0]?.trim().toLowerCase();
+    }
+    const delivery = { mode: "announce", to: peerId };
+    if (channel) {
+        delivery.channel = channel;
+    }
+    return delivery;
+}
 export function createCronTool(opts) {
     return {
         label: "Cron",
@@ -132,27 +201,36 @@ JOB SCHEMA (for add action):
   "name": "string (optional)",
   "schedule": { ... },      // Required: when to run
   "payload": { ... },       // Required: what to execute
+  "delivery": { ... },      // Optional: announce summary (isolated only)
   "sessionTarget": "main" | "isolated",  // Required
   "enabled": true | false   // Optional, default true
 }
 
 SCHEDULE TYPES (schedule.kind):
 - "at": One-shot at absolute time
-  { "kind": "at", "atMs": <unix-ms-timestamp> }
+  { "kind": "at", "at": "<ISO-8601 timestamp>" }
 - "every": Recurring interval
   { "kind": "every", "everyMs": <interval-ms>, "anchorMs": <optional-start-ms> }
 - "cron": Cron expression
   { "kind": "cron", "expr": "<cron-expression>", "tz": "<optional-timezone>" }
 
+ISO timestamps without an explicit timezone are treated as UTC.
+
 PAYLOAD TYPES (payload.kind):
 - "systemEvent": Injects text as system event into session
   { "kind": "systemEvent", "text": "<message>" }
 - "agentTurn": Runs agent with message (isolated sessions only)
-  { "kind": "agentTurn", "message": "<prompt>", "model": "<optional>", "thinking": "<optional>", "timeoutSeconds": <optional>, "deliver": <optional-bool>, "channel": "<optional>", "to": "<optional>", "bestEffortDeliver": <optional-bool> }
+  { "kind": "agentTurn", "message": "<prompt>", "model": "<optional>", "thinking": "<optional>", "timeoutSeconds": <optional> }
+
+DELIVERY (isolated-only, top-level):
+  { "mode": "none|announce", "channel": "<optional>", "to": "<optional>", "bestEffort": <optional-bool> }
+  - Default for isolated agentTurn jobs (when delivery omitted): "announce"
+  - If the task needs to send to a specific chat/recipient, set delivery.channel/to here; do not call messaging tools inside the run.
 
 CRITICAL CONSTRAINTS:
 - sessionTarget="main" REQUIRES payload.kind="systemEvent"
 - sessionTarget="isolated" REQUIRES payload.kind="agentTurn"
+Default: prefer isolated agentTurn jobs unless the user explicitly wants a main-session system event.
 
 WAKE MODES (for wake action):
 - "next-heartbeat" (default): Wake on next heartbeat
@@ -166,7 +244,7 @@ Use jobId as the canonical identifier; id is accepted for compatibility. Use con
             const gatewayOpts = {
                 gatewayUrl: readStringParam(params, "gatewayUrl", { trim: false }),
                 gatewayToken: readStringParam(params, "gatewayToken", { trim: false }),
-                timeoutMs: typeof params.timeoutMs === "number" ? params.timeoutMs : undefined,
+                timeoutMs: typeof params.timeoutMs === "number" ? params.timeoutMs : 60_000,
             };
             switch (action) {
                 case "status":
@@ -176,6 +254,52 @@ Use jobId as the canonical identifier; id is accepted for compatibility. Use con
                         includeDisabled: Boolean(params.includeDisabled),
                     }));
                 case "add": {
+                    // Flat-params recovery: non-frontier models (e.g. Grok) sometimes flatten
+                    // job properties to the top level alongside `action` instead of nesting
+                    // them inside `job`. When `params.job` is missing or empty, reconstruct
+                    // a synthetic job object from any recognised top-level job fields.
+                    // See: https://github.com/openclaw/openclaw/issues/11310
+                    if (!params.job ||
+                        (typeof params.job === "object" &&
+                            params.job !== null &&
+                            Object.keys(params.job).length === 0)) {
+                        const JOB_KEYS = new Set([
+                            "name",
+                            "schedule",
+                            "sessionTarget",
+                            "wakeMode",
+                            "payload",
+                            "delivery",
+                            "enabled",
+                            "description",
+                            "deleteAfterRun",
+                            "agentId",
+                            "message",
+                            "text",
+                            "model",
+                            "thinking",
+                            "timeoutSeconds",
+                            "allowUnsafeExternalContent",
+                        ]);
+                        const synthetic = {};
+                        let found = false;
+                        for (const key of Object.keys(params)) {
+                            if (JOB_KEYS.has(key) && params[key] !== undefined) {
+                                synthetic[key] = params[key];
+                                found = true;
+                            }
+                        }
+                        // Only use the synthetic job if at least one meaningful field is present
+                        // (schedule, payload, message, or text are the minimum signals that the
+                        // LLM intended to create a job).
+                        if (found &&
+                            (synthetic.schedule !== undefined ||
+                                synthetic.payload !== undefined ||
+                                synthetic.message !== undefined ||
+                                synthetic.text !== undefined)) {
+                            params.job = synthetic;
+                        }
+                    }
                     if (!params.job || typeof params.job !== "object") {
                         throw new Error("job required");
                     }
@@ -189,6 +313,28 @@ Use jobId as the canonical identifier; id is accepted for compatibility. Use con
                             job.agentId = agentId;
                         }
                     }
+                    if (opts?.agentSessionKey &&
+                        job &&
+                        typeof job === "object" &&
+                        "payload" in job &&
+                        job.payload?.kind === "agentTurn") {
+                        const deliveryValue = job.delivery;
+                        const delivery = isRecord(deliveryValue) ? deliveryValue : undefined;
+                        const modeRaw = typeof delivery?.mode === "string" ? delivery.mode : "";
+                        const mode = modeRaw.trim().toLowerCase();
+                        const hasTarget = (typeof delivery?.channel === "string" && delivery.channel.trim()) ||
+                            (typeof delivery?.to === "string" && delivery.to.trim());
+                        const shouldInfer = (deliveryValue == null || delivery) && mode !== "none" && !hasTarget;
+                        if (shouldInfer) {
+                            const inferred = inferDeliveryFromSessionKey(opts.agentSessionKey);
+                            if (inferred) {
+                                job.delivery = {
+                                    ...delivery,
+                                    ...inferred,
+                                };
+                            }
+                        }
+                    }
                     const contextMessages = typeof params.contextMessages === "number" && Number.isFinite(params.contextMessages)
                         ? params.contextMessages
                         : 0;
@@ -237,7 +383,8 @@ Use jobId as the canonical identifier; id is accepted for compatibility. Use con
                     if (!id) {
                         throw new Error("jobId required (id accepted for backward compatibility)");
                     }
-                    return jsonResult(await callGatewayTool("cron.run", gatewayOpts, { id }));
+                    const runMode = params.runMode === "due" || params.runMode === "force" ? params.runMode : "force";
+                    return jsonResult(await callGatewayTool("cron.run", gatewayOpts, { id, mode: runMode }));
                 }
                 case "runs": {
                     const id = readStringParam(params, "jobId") ?? readStringParam(params, "id");