@mono-agent/agent-app 0.11.5 → 0.13.0

package/README.md

@@ -3,7 +3,7 @@
 Config-first mono-agent host. Reads one `mono-agent.config.json` in a folder,
 builds the configured responder, and starts every configured communication
 channel plus traceability. Ships the
-`mono-agent` CLI (`init`, `auth`, `sandbox`, `validate`, `memory`, `tui`, `start`) so an agent folder works without
+`mono-agent` CLI (`init`, `auth`, `sandbox`, `validate`, `memory`, `tui`, `web`, `start`) so an agent folder works without
 hand-written composition code.
 
 Setup has two deliberate wall-clock paths: flags or non-TTY input use the fast scaffold-only path (unless explicit `--auth` adds provider setup) and never claim readiness. Bare `mono-agent init` on a TTY makes one real no-tool model call per selected route before committing the scaffold, with timeouts of 90s for each cloud route and 240s for each local route.
@@ -42,6 +42,10 @@ Turn a folder's `mono-agent.config.json` into a running agent host:
   provider-free strict health and payload-free intake inspect/retry/resolve).
 - Scaffold (`mono-agent init`) and validate (`mono-agent validate`) agent
   folders non-destructively.
+- Operate the machine-wide `@mono-agent/web` assistant-ui console through
+  `mono-agent web`. The `@mono-agent/session-web` recorder still ships but its
+  `mono-agent sessions` launcher was removed; use `mono-agent tui`
+  (recorded-run replay) or `mono-agent web` (live console).
 
 ## Install / Usage
 
@@ -116,7 +120,7 @@ action fails the check.
 Escape or Ctrl-C interrupts preflight; recovery can resume verified routes when
 the non-secret plan fingerprint still matches, restart all checks, edit choices,
 or cancel. Authentication repair clears every prior route proof because it can
-replace credential bytes. Guided commit atomically creates the config and rechecks its exact snapshot after validation. On macOS it then creates or refreshes the canonical per-config launchd service, waits for a fresh `startup-complete` trace source, and opens `mono-agent tui --configure` remotely against that same background responder. A background-start failure preserves the committed files, skips the chat, and prints exact `start`, `status`, and `logs --follow` recovery commands plus log paths. Off macOS, conversational configuration is unavailable: the wizard preserves the files and gives manual edit/validate, foreground-start, and ordinary-TUI guidance without claiming readiness. Any flag or non-TTY invocation remains scaffold-only and never starts a process.
+replace credential bytes. Guided commit atomically creates the config and rechecks its exact snapshot after validation. On macOS it then creates or refreshes the canonical per-config launchd service and waits up to 60 seconds for a fresh trace whose durable `metadata.lifecycle.startupCompleted` proof is true. The worker publishes that proof only after channels, memory rituals, and final memory-health work complete; later trace refreshes change the diagnostic `metadata.reason` without revoking readiness. The controller also re-proves the live launchd PID, exact snapshot, current channel/memory health, and reachable TUI before it opens `mono-agent tui --configure` against that background responder. A readiness timeout or trace/TUI-probe error preserves the committed files and skips chat, then unloads the worker plus scheduled maintenance and removes their definitions only when stopped state is proven. If cleanup cannot be proven, the command says that a process may still be running and prints exact `start`, `status`, and `logs --follow` recovery commands plus log paths. Workers from an older release that have no durable lifecycle marker must restart once before configuration can attach. Off macOS, conversational configuration is unavailable: the wizard preserves the files and gives manual edit/validate, foreground-start, and ordinary-TUI guidance without claiming readiness. Any flag or non-TTY invocation remains scaffold-only and never starts a process.
 
 Every scaffold selects versioned `mono-agent-configure` and `mono-agent-memory`
 skills from `./skills` with index disclosure. `ReadSkill` remains separate from
@@ -126,14 +130,28 @@ canonical owner-only non-symlink parent chain, per-project owner lock, and
 compare-and-swap activation prevent outside or concurrent
 operator edits from being overwritten, and a partial activation restores only
 files that still equal the managed bytes it wrote.
-
-In the separate **Temporary post-wizard configuration mode** only, the background app injects proposal-only
-`ProposeAgentConfiguration`. The opening message says to discuss the agent's Role,
-behavior, memory, skills, tools, or channels; never enter secrets; and expect a
-separate host approval before anything changes. Reply `done` or `no changes` to
-finish without edits. It also says ordinary chat starts
-after the reply and any approval or rejection, while `/quit` closes only the console
-and leaves the background agent running. The host accepts only a fail-closed low-risk
+The persistent SELF-CONFIG workflow guidance is managed-skill version `1.2.0`.
+Existing unchanged copies are reported as stale and are never rewritten on TUI
+startup; run `mono-agent install-skill --project --update` explicitly to refresh them.
+
+Harness-mode `mono-agent install-skill` also pairs the exact matching
+`@mono-agent/docs-mcp` version with available selected Codex and Claude Code
+CLIs. That read-only companion gives `mono-agent-composer` offline semantic and
+exact-identifier search over the public docs and its authoritative references.
+Use `--no-docs-mcp` for a skill-only install. Managed MCP and skill changes are
+transactional; an unrelated entry named `mono-agent-docs` is never overwritten,
+including with `--force`. Project `--check` / `--update` mode does not touch
+harness MCP configuration.
+
+In the separate, visibly marked **SELF-CONFIG** session only, the background app injects proposal-only
+`ProposeAgentConfiguration`. The opening message shows a user-led map of identity/knowledge,
+runtime/models, skills/tools/MCP/plugins, memory, channels/APIs/A2A, automation,
+security, observability/operations, and acceptance criteria, then builds the chosen
+workflow conversationally. It says never to enter secrets and to expect a separate
+host approval before anything changes. Approval, rejection, a proposal-free turn,
+`done`, and `no changes` all keep SELF-CONFIG active; only `/quit`, `/exit`, or
+double `ctrl+c` exits the session, and quitting leaves the background agent running.
+The host accepts only a fail-closed low-risk
 allowlist: public name; effort, turn/session UX; selected project skills and
 disclosure; memory size or MemoryRecall enablement; semantic tool-policy
 tightening; and the separately validated Role body. Every path, memory-tier or
@@ -150,12 +168,15 @@ tool only. Pure direct-Codex chains use its native read-only plan posture;
 mixed chains keep the finite proposal surface so a route that cannot represent
 it cannot widen authority. Direct OpenCode cannot receive the host-owned MCP
 proposal capability: a direct-OpenCode primary is routed through a configured
-proposal-capable fallback, while a direct-OpenCode fallback makes temporary
-configuration unavailable with explicit remediation. The approval card shows
+proposal-capable fallback, while a direct-OpenCode fallback makes self-configuration
+unavailable with explicit remediation. The approval card shows
 every full, untruncated JSON patch value and pages through the exact Role body
 while keeping Reject/Approve reachable, and rejects
-terminal-control or bidi-control review text before displaying it. Fast follow-ups wait through responder rotation.
-Ordinary chat uses a different conversation id. A proposal-free finish, rejection, successful approval, or recovered rollback ends the temporary mode and activates ordinary chat; `/quit` closes only the console while the daemon keeps running. Remote/proactive channels never receive this tool.
+terminal-control or bidi-control review text before displaying it. The configuration
+conversation id stays stable across incremental checkpoints and verified restarts;
+each settled turn receives a fresh opaque proposal capability plus a safe host-outcome
+summary. Fast follow-up text remains in the editor until settlement and is never sent
+as ordinary chat or to a stale endpoint. Remote/proactive channels never receive this tool.
 
 Before the first macOS background launch, the CLI copies the exact package and
 already-resolved dependency closure it is currently executing—including configured
@@ -168,7 +189,16 @@ digest are bound into the runtime marker and verified on every reuse. The Launch
 `npm create`/npx cache. Existing verified runtime snapshots are reused and
 retained because another agent may still reference them. A loaded job is fully
 booted out and bootstrapped again so rewritten arguments and environment are
-adopted. Launchd enters Node through `/usr/bin/env -i`, so inherited variables
+adopted. During a slow install, the existing healthy worker remains loaded. An
+owner-private per-instance publication barrier makes any KeepAlive respawn wait
+until the replacement closure and plist are committed; dead or PID-reused
+controller ownership is recovered by process incarnation. The replacement
+plist carries a path-free proof of the finalized marker, and the worker
+revalidates its exact canonical CLI, marker, manifest fingerprint, and launch
+boundary before loading config or channels. Only that verified active closure
+is automatically reopened read-only by app-owned SRT; the runtimes parent and
+historical sibling closures remain outside the implicit policy. Launchd enters
+Node through `/usr/bin/env -i`, so inherited variables
 such as `NODE_OPTIONS` cannot execute before the worker's allowlisted environment
 is established. Every foreground worker holds one owner-only lifetime lease for its
 canonical config, so a managed and manual host cannot run together. A per-config
@@ -270,6 +300,12 @@ bounded by newest whole interactions, without changing the outward message or
 long-term memory capture. `TelegramAskButtons` with `wait: false` continues to produce a
 synthetic next turn when the user taps later.
 
+For blocking `TelegramAskButtons`, the next plain-text Telegram message is also
+a valid custom answer. It resolves the same in-flight tool call and the app asks
+the Telegram sink to remove the inline keyboard. The built-in Telegram `/new`
+command uses the configured responder's host-owned reset surface to clear only
+that conversation and force skill/startup-context reload on its next turn.
+
 The app publishes a cached, content-free `memoryHealth` snapshot in the primary
 trace-source heartbeat and any enabled best-effort global mirror. Built-in
 health is computed through a dynamic memory import so a native SQLite ABI
@@ -318,8 +354,9 @@ a declared but missing variable stays `waiting` and never retries keyless.
 Changing provider, model, or dimension on an existing root requires a stopped,
 config-aware `mono-agent memory rebuild --json`. BuJo uses the selected
 embeddings service independently from its explicit capture LLM (`agent-host` in
-generated configs, or an authored Ollama block). The advanced standalone
-`memory-bujo migrate` command remains Ollama-only and outside guided init.
+generated configs, or an authored Ollama block). The standalone `memory-bujo`
+maintenance CLI has been removed; run every memory operation config-aware through
+`mono-agent memory <subcommand>` from the agent folder.
 `retry` makes dead/delayed intake due for the
 next store start; `resolve` explicitly abandons one item without claiming
 capture succeeded, keeps permanent duplicate protection, and refuses a retained

package/dist/adapter-send-tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adapter-send-tools.d.ts","sourceRoot":"","sources":["../src/adapter-send-tools.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"adapter-send-tools.d.ts","sourceRoot":"","sources":["../src/adapter-send-tools.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGpE,OAAO,KAAK,EAEV,WAAW,EACZ,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAGV,qBAAqB,EAGtB,MAAM,8BAA8B,CAAC;AAGtC,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAmB/D;;;;;;;;;GASG;AAEH,eAAO,MAAM,kCAAkC,4BAA4B,CAAC;AAE5E,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,iBAAiB,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9C,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;CACpC;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3C,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,uFAAuF;IACvF,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,uFAAuF;IACvF,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,mFAAmF;IACnF,QAAQ,CAAC,KAAK,EAAE;QACd,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;QACvB,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;QACtB,8EAA8E;QAC9E,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;KACxB,CAAC;IACF,QAAQ,CAAC,SAAS,CAAC,EAAE,mBAAmB,CAAC;IACzC,QAAQ,CAAC,SAAS,CAAC,EAAE;QACnB,QAAQ,CAAC,KAAK,CAAC,EAAE,wBAAwB,CAAC;QAC1C,QAAQ,CAAC,SAAS,CAAC,EAAE,YAAY,CAAC;KACnC,CAAC;IACF,4EAA4E;IAC5E,QAAQ,CAAC,uBAAuB,CAAC,EAAE,MAAM,CAAC;IAC1C,8EAA8E;IAC9E,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,8EAA8E;IAC9E,QAAQ,CAAC,iBAAiB,CAAC,EAAE,YAAY,CAAC;CAC3C;AAED;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,KAAK,CAAC,EAAE,qBAAqB,CAAC;IACvC,QAAQ,CAAC,QAAQ,CAAC,EAAE,wBAAwB,CAAC;IAC7C,QAAQ,CAAC,OAAO,CAAC,EAAE,mBAAmB,CAAC;CACxC;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,WAAW,EAAE,iBAAiB,CAAC,CAAC;IACtD,QAAQ,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC,qBAAqB,EAAE,aAAa,GAAG,cAAc,GAAG,WAAW,GAAG,iBAAiB,CAAC,CAAC;CACnH;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IAClC,QAAQ,CAAC,eAAe,CAAC,EAAE,+BAA+B,CAAC;CAC5D;AAED,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,+CAA+C;IAC9D,8BAA8B,CAAC,KAAK,EAAE;QACpC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,sBAAsB,EAAE,MAAM,CAAC;QACxC,QAAQ,CAAC,eAAe,EAAE,SAAS,CAAC,OAAO,GAAG,UAAU,CAAC,EAAE,CAAC;KAC7D,GAAG;QAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,IAAI,IAAI,CAAA;KAAE,CAAC;CACvE;AAED,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,CAAC,cAAc,EAAE;QACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAC9C,CAAC;IACF,QAAQ,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9C;AAED;;;;GAIG;AACH,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,sEAAsE;AACtE,UAAU,4BAA4B;IACpC,QAAQ,CAAC,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACxD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IACtD,QAAQ,CAAC,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IACzD,QAAQ,CAAC,MAAM,CAAC,EAAE;QAChB,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;KACtE,GAAG,SAAS,CAAC;IACd,qFAAqF;IACrF,QAAQ,CAAC,wBAAwB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACxD,+EAA+E;IAC/E,QAAQ,CAAC,WAAW,CAAC,EAAE,8BAA8B,GAAG,SAAS,CAAC;CACnE;AAED,wBAAsB,+BAA+B,CACnD,KAAK,EAAE,uBAAuB,EAC9B,OAAO,GAAE,8BAAmC,GAC3C,OAAO,CAAC,wBAAwB,GAAG,SAAS,CAAC,CAgC/C;AA8BD,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,wBAAwB,GAAG,SAAS,MAAM,EAAE,CAkB1F;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE;IAAE,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAAC,QAAQ,CAAC,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,GAClG,OAAO,CAET;AAED;;;;GAIG;AACH,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,iBAAiB,CAAC,EAAE,YAAY,CAAC;IAC1C,QAAQ,CAAC,eAAe,CAAC,EAAE,+BAA+B,CAAC;CAC5D;AAED,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,SAAS,MAAM,EAAE,EAC/B,OAAO,CAAC,EAAE,4BAA4B,EACtC,WAAW,CAAC,EAAE,8BAA8B,GAC3C,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAiCxB;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,KAAK,EAAE,uBAAuB,CAAC;IACxC,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,QAAQ,CAAC,QAAQ,CAAC,EAAE,wBAAwB,CAAC;IAC7C,QAAQ,CAAC,eAAe,CAAC,EAAE,+BAA+B,CAAC;CAC5D;AAED,wBAAgB,kCAAkC,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,2BAA2B,CAwBpI;AAED,wBAAgB,6BAA6B,CAC3C,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,MAAM,EACX,YAAY,EAAE,SAAS,MAAM,EAAE,EAC/B,OAAO,CAAC,EAAE,4BAA4B,EACtC,WAAW,CAAC,EAAE,8BAA8B,GAC3C,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAqBzB;AAED;;;;;GAKG;AACH,wBAAgB,sCAAsC,CACpD,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,MAAM,EACX,YAAY,EAAE,SAAS,MAAM,EAAE,EAC/B,SAAS,CAAC,EAAE,MAAM,EAClB,WAAW,CAAC,EAAE,8BAA8B,EAC5C,aAAa,CAAC,EAAE,MAAM,EACtB,+BAA+B,CAAC,EAAE,+CAA+C,GAChF,CAAC,KAAK,EAAE,4BAA4B,KAAK,OAAO,CAAC,gCAAgC,CAAC,CAiEpF;AAED,wBAAsB,6BAA6B,CACjD,QAAQ,EAAE,wBAAwB,EAClC,OAAO,GAAE,2BAAgC,GACxC,OAAO,CAAC,uBAAuB,CAAC,CAmBlC;AAED,wBAAsB,4BAA4B,CAChD,QAAQ,EAAE,wBAAwB,EAClC,OAAO,EAAE,uBAAuB,EAChC,QAAQ,CAAC,EAAE,wBAAwB,EACnC,OAAO,GAAE,2BAAgC,GACxC,OAAO,CAAC,SAAS,CAAC,CA+CpB;AA0nCD,UAAU,YAAY;IACpB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB"}

package/dist/adapter-send-tools.js

@@ -351,9 +351,7 @@ async function awaitBridgeAsk(settings, askId, toolName, extra, fetchImpl, signa
             await sendAskProgress(extra, Math.round((Date.now() - startedMs) / 1000));
             const status = poll.body.status;
             if (status === "answered" && typeof poll.body.answer === "string") {
-                const answeredText = toolName === "TelegramAskButtons"
-                    ? `The user tapped:\n${poll.body.answer}`
-                    : `The user answered:\n${poll.body.answer}`;
+                const answeredText = `The user answered:\n${poll.body.answer}`;
                 return askToolResult(answeredText, { answered: true, answer: poll.body.answer }, extraStructured);
             }
             if (status === "expired") {
@@ -578,7 +576,7 @@ function registerTelegramSendTool(server, settings, client, deliveryHistory, fet
             disable_web_page_preview: z.boolean().optional().describe("Disable Telegram link previews."),
         },
     }, async (args, extra) => {
-        assertTelegramChatAllowed(settings, args.chat_id);
+        assertTelegramChatAllowed(settings, args.chat_id, "TelegramSendMessage");
         const result = await client.sendMessage({
             chat_id: args.chat_id,
             text: args.text,
@@ -677,10 +675,42 @@ async function editExpiredTelegramAskMessage(client, adapter, params) {
         // Best-effort: a failed expiry edit must never replace the ask result.
     }
 }
+/**
+ * Best-effort: remove a keyboard that was sent but could not be registered with
+ * the interaction bridge. Re-editing without reply_markup clears the buttons;
+ * use an independent bounded signal and preserve the primary bridge failure.
+ */
+async function dismissUnregisteredTelegramAskKeyboard(client, adapter, params) {
+    try {
+        const rendered = adapter.renderTelegramMarkdown(params.rawSource);
+        const signal = AbortSignal.timeout(TELEGRAM_ASK_EXPIRY_EDIT_TIMEOUT_MS);
+        try {
+            await client.editMessageText({
+                chat_id: params.chat_id,
+                message_id: params.message_id,
+                text: rendered,
+                parse_mode: "MarkdownV2",
+            }, { signal });
+        }
+        catch (error) {
+            if (!isTelegramParseError(error, adapter)) {
+                throw error;
+            }
+            await client.editMessageText({
+                chat_id: params.chat_id,
+                message_id: params.message_id,
+                text: params.rawSource,
+            }, { signal });
+        }
+    }
+    catch {
+        // Best-effort: keyboard cleanup must not replace the bridge failure.
+    }
+}
 function registerTelegramAskTool(server, settings, client, adapter, fetchImpl) {
     server.registerTool("TelegramAskButtons", {
         title: "Ask via Telegram buttons",
-        description: "Ask the owner a question in an allowed Telegram chat with tappable inline-keyboard buttons (e.g. a confirmation or a multiple-choice). By default WAITS for their tap (up to the ask timeout) and returns the tapped label; a second concurrent ask in the same chat fails. On a proactive or scheduled turn (cron/heartbeat) set `wait:false`: the buttons are sent and the tool returns immediately, and the tap arrives later as a new message quoting the question.",
+        description: "Ask the owner a question in an allowed Telegram chat with tappable inline-keyboard buttons (e.g. a confirmation or a multiple-choice). By default WAITS for either a button tap or the owner's next plain-text custom reply (up to the ask timeout) and returns that answer; a second concurrent ask in the same chat fails. On a proactive or scheduled turn (cron/heartbeat) set `wait:false`: the buttons are sent and the tool returns immediately, and the tap arrives later as a new message quoting the question.",
         inputSchema: {
             chat_id: z.union([z.string().min(1), z.number().int()]).describe("Telegram chat id from the adapter allowlist."),
             question: z.string().min(1).describe("The question to show above the buttons."),
@@ -688,15 +718,15 @@ function registerTelegramAskTool(server, settings, client, adapter, fetchImpl) {
                 .array(z.string().min(1).max(100))
                 .min(2)
                 .max(adapter.TELEGRAM_ASK_MAX_OPTIONS)
-                .describe("Button labels (2–8). The label the user taps is echoed back as a new message."),
+                .describe("Button labels (2–8). A tap returns its label; while waiting, plain text is accepted as a custom answer."),
             note: z.string().min(1).optional().describe("Optional extra context shown beneath the question."),
             wait: z
                 .boolean()
                 .optional()
-                .describe("Default true: block until the user taps (up to the ask timeout). Set false on proactive/scheduled (cron/heartbeat) turns — send the buttons and return immediately; the tapped answer arrives later as a new message quoting the question."),
+                .describe("Default true: block for a button tap or custom text reply (up to the ask timeout). Set false on proactive/scheduled (cron/heartbeat) turns — send the buttons and return immediately; a tapped answer arrives later as a new message quoting the question."),
         },
     }, async (args, extra) => {
-        assertTelegramChatAllowed(settings, args.chat_id);
+        assertTelegramChatAllowed(settings, args.chat_id, "TelegramAskButtons");
         const inlineKeyboard = args.options.map((label, index) => [
             { text: label, callback_data: adapter.telegramAskCallbackData(index) },
         ]);
@@ -761,6 +791,33 @@ function registerTelegramAskTool(server, settings, client, adapter, fetchImpl) {
             await cleanupBridgeAskBestEffort(bridge, fetchImpl, askId);
             throw error;
         }
+        const presentation = await (async () => {
+            try {
+                return await askBridgeRequest(bridge, fetchImpl, "PUT", `/v1/asks/${encodeURIComponent(askId)}/presentation`, { messageRef: String(result.message_id) }, extra.signal);
+            }
+            catch (error) {
+                await Promise.all([
+                    cleanupBridgeAskBestEffort(bridge, fetchImpl, askId),
+                    dismissUnregisteredTelegramAskKeyboard(client, adapter, {
+                        chat_id: result.chat.id,
+                        message_id: result.message_id,
+                        rawSource: source,
+                    }),
+                ]);
+                throw error;
+            }
+        })();
+        if (presentation.status !== 204) {
+            await Promise.all([
+                cleanupBridgeAskBestEffort(bridge, fetchImpl, askId),
+                dismissUnregisteredTelegramAskKeyboard(client, adapter, {
+                    chat_id: result.chat.id,
+                    message_id: result.message_id,
+                    rawSource: source,
+                }),
+            ]);
+            throw new Error(`TelegramAskButtons: the interaction bridge rejected the keyboard reference (HTTP ${String(presentation.status)}).`);
+        }
         const askResult = await awaitBridgeAsk(bridge, askId, "TelegramAskButtons", extra, fetchImpl, extra.signal, {
             chat_id: result.chat.id,
             message_id: result.message_id,
@@ -787,24 +844,36 @@ function registerTelegramAskTool(server, settings, client, adapter, fetchImpl) {
  * shown inline). Both accept the file as base64 `data` (with a `filename`) OR a
  * workspace `path` (filename derived from the basename), enforce the adapter
  * allowlist, and bound the size to the adapter's inbound cap before uploading via
- * the adapter-owned sender.
+ * the adapter-owned sender. Producing-conversation scope omits `chat_id` from the
+ * schema and derives it from trusted request context instead.
  */
 function registerTelegramSendFileTool(server, settings, client, adapter) {
+    const producingConversationScope = settings.sendTools?.scope === "producing-conversation";
+    const inputSchema = {
+        kind: z.enum(["document", "photo"]).describe("`document` for any file (downloadable), `photo` for an image shown inline."),
+        ...(producingConversationScope
+            ? {}
+            : {
+                chat_id: z
+                    .union([z.string().min(1), z.number().int()])
+                    .describe("Telegram chat id from the adapter allowlist."),
+            }),
+        data: z.string().min(1).optional().describe("Base64-encoded file bytes. Provide this or `path`."),
+        path: z.string().min(1).optional().describe("Path to a file to upload (resolved against the agent working dir). Provide this or `data`."),
+        filename: z.string().min(1).optional().describe("Filename to present. Required with `data` for a document; derived from `path` otherwise."),
+        caption: z.string().min(1).optional().describe("Optional caption shown with the file."),
+    };
     server.registerTool("TelegramSendFile", {
         title: "Send Telegram file",
-        description: "Upload and send a file to an allowed Telegram chat. Set `kind:\"document\"` to send any file (shown as a downloadable document) or `kind:\"photo\"` to send an image inline. Provide the bytes as base64 `data` (with a `filename` — required for a document), or a workspace `path`. A self-hosted Bot API can stream legacy path uploads; strict run-output paths are always read through a pinned descriptor.",
-        inputSchema: {
-            kind: z.enum(["document", "photo"]).describe("`document` for any file (downloadable), `photo` for an image shown inline."),
-            chat_id: z.union([z.string().min(1), z.number().int()]).describe("Telegram chat id from the adapter allowlist."),
-            data: z.string().min(1).optional().describe("Base64-encoded file bytes. Provide this or `path`."),
-            path: z.string().min(1).optional().describe("Path to a file to upload (resolved against the agent working dir). Provide this or `data`."),
-            filename: z.string().min(1).optional().describe("Filename to present. Required with `data` for a document; derived from `path` otherwise."),
-            caption: z.string().min(1).optional().describe("Optional caption shown with the file."),
-        },
+        description: producingConversationScope
+            ? "Upload and send a file to the Telegram conversation that produced this run. The host binds the destination; provide only the file content or path. Set `kind:\"document\"` to send any file (shown as a downloadable document) or `kind:\"photo\"` to send an image inline. Strict run-output paths are always read through a pinned descriptor."
+            : "Upload and send a file to an allowed Telegram chat. Set `kind:\"document\"` to send any file (shown as a downloadable document) or `kind:\"photo\"` to send an image inline. Provide the bytes as base64 `data` (with a `filename` — required for a document), or a workspace `path`. A self-hosted Bot API can stream legacy path uploads.",
+        inputSchema,
     }, async (args, extra) => {
         extra.signal.throwIfAborted();
         const kind = args.kind;
-        assertTelegramChatAllowed(settings, args.chat_id);
+        const requestedChatId = "chat_id" in args ? args.chat_id : undefined;
+        const chatId = resolveTelegramSendFileChatId(settings, requestedChatId);
         if ((args.data !== undefined) === (args.path !== undefined)) {
             throw new Error("provide exactly one of `data` (base64) or `path`.");
         }
@@ -830,15 +899,12 @@ function registerTelegramSendFileTool(server, settings, client, adapter) {
             }
             try {
                 const sent = await client.sendDocument({
-                    chat_id: args.chat_id,
+                    chat_id: chatId,
                     document: pathToFileURL(uploadPath).href,
                     ...(args.caption === undefined ? {} : { caption: args.caption }),
                 }, { signal: extra.signal });
                 const name = basename(uploadPath);
-                return {
-                    content: [{ type: "text", text: `Sent ${kind} ${sent.message_id} (${name}) to ${String(sent.chat.id)}.` }],
-                    structuredContent: { ok: true, chat_id: sent.chat.id, message_id: sent.message_id, filename: name },
-                };
+                return telegramSendFileResult(producingConversationScope, kind, sent, name);
             }
             catch (error) {
                 // Retry buffered exactly once; rethrow anything that isn't a server-side rejection.
@@ -858,23 +924,49 @@ function registerTelegramSendFileTool(server, settings, client, adapter) {
         });
         const result = kind === "document"
             ? await client.sendDocument({
-                chat_id: args.chat_id,
+                chat_id: chatId,
                 document: bytes,
                 filename,
                 ...(args.caption === undefined ? {} : { caption: args.caption }),
             }, { signal: extra.signal })
             : await client.sendPhoto({
-                chat_id: args.chat_id,
+                chat_id: chatId,
                 photo: bytes,
                 filename,
                 ...(args.caption === undefined ? {} : { caption: args.caption }),
             }, { signal: extra.signal });
-        return {
-            content: [{ type: "text", text: `Sent ${kind} ${result.message_id} (${filename}) to ${String(result.chat.id)}.` }],
-            structuredContent: { ok: true, chat_id: result.chat.id, message_id: result.message_id, filename },
-        };
+        return telegramSendFileResult(producingConversationScope, kind, result, filename);
     });
 }
+function resolveTelegramSendFileChatId(settings, requestedChatId) {
+    if (settings.sendTools?.scope === "producing-conversation") {
+        const producingChatId = telegramChatIdFromConversation(settings.producingConversationId);
+        if (producingChatId === undefined) {
+            throw new Error("TelegramSendFile: producing Telegram conversation context is unavailable.");
+        }
+        assertTelegramChatAllowed(settings, producingChatId, "TelegramSendFile");
+        return producingChatId;
+    }
+    if (requestedChatId === undefined) {
+        throw new Error("TelegramSendFile: chat_id is required outside producing-conversation scope.");
+    }
+    assertTelegramChatAllowed(settings, requestedChatId, "TelegramSendFile");
+    return requestedChatId;
+}
+function telegramSendFileResult(producingConversationScope, kind, sent, filename) {
+    const destination = producingConversationScope
+        ? "the producing Telegram conversation"
+        : String(sent.chat.id);
+    return {
+        content: [{ type: "text", text: `Sent ${kind} ${sent.message_id} (${filename}) to ${destination}.` }],
+        structuredContent: {
+            ok: true,
+            ...(producingConversationScope ? {} : { chat_id: sent.chat.id }),
+            message_id: sent.message_id,
+            filename,
+        },
+    };
+}
 /** Resolve the upload bytes + filename from exactly one of base64 `data` or a `path`. */
 async function resolveTelegramFileBytes(input) {
     const hasData = input.data !== undefined;
@@ -1070,21 +1162,21 @@ function assertSlackChannelAllowed(settings, channel) {
     }
     throw new Error("SlackSendMessage: channel is not allowed by Slack adapter config.");
 }
-function assertTelegramChatAllowed(settings, chatId) {
+function assertTelegramChatAllowed(settings, chatId, toolName) {
     const normalized = String(chatId);
     if (settings.sendTools?.scope === "producing-conversation") {
         const producingChatId = telegramChatIdFromConversation(settings.producingConversationId);
         if (producingChatId === undefined) {
-            throw new Error("TelegramSendMessage: producing Telegram conversation context is unavailable.");
+            throw new Error(`${toolName}: producing Telegram conversation context is unavailable.`);
         }
         if (normalized !== producingChatId) {
-            throw new Error("TelegramSendMessage: chat_id must match the producing Telegram conversation.");
+            throw new Error(`${toolName}: chat_id must match the producing Telegram conversation.`);
         }
     }
     if (settings.allowAllChats || settings.allowedChatIds.includes(normalized)) {
         return;
     }
-    throw new Error("TelegramSendMessage: chat_id is not allowed by Telegram adapter config.");
+    throw new Error(`${toolName}: chat_id is not allowed by Telegram adapter config.`);
 }
 function telegramChatIdFromConversation(conversationId) {
     if (conversationId === undefined)