@markusylisiurunen/tau 0.3.93 → 0.3.95

package/dist/core/subagents/native_subagent_runtime.js

@@ -0,0 +1,270 @@
+import { AgentRuntime, createAgentSpec } from "../agent/agent_runtime.js";
+import { resolveAgentModel } from "../runtime/agent_model.js";
+import { createAutoCompactionArchiver } from "../session/auto_compaction_archive.js";
+import { ToolCatalog } from "../tools/catalog.js";
+import { getUsageCostTotal, getUsageTotals } from "../usage/logs.js";
+import { extractAssistantText } from "../utils/messages.js";
+import { runtimeFailure } from "./errors.js";
+function nativeContent(content) {
+    return content.map((block) => block.type === "text"
+        ? { type: "text", text: block.text }
+        : { type: "image", data: block.data, mimeType: block.mimeType });
+}
+export class NativeSubagentRuntime {
+    config;
+    options;
+    agent;
+    jobs;
+    toolPresentations = new Map();
+    toolOutcomes = new Map();
+    blockedToolCalls = new Map();
+    steering = [];
+    deliveries = new Set();
+    interrupted = false;
+    constructor(config, options) {
+        this.config = config;
+        this.options = options;
+        this.jobs = options.jobs.create();
+        this.agent = new AgentRuntime({
+            agentId: options.id,
+            spec: createAgentSpec({
+                autoCompactThresholdTokens: null,
+                ...resolveAgentModel({
+                    id: `${options.personaId ?? "agent"}-subagent`,
+                    label: "subagent",
+                    description: "Background agent",
+                    source: "project",
+                    systemPrompt: config.systemPrompt,
+                    model: config.model,
+                    settings: config.settings,
+                    tools: config.tools,
+                    subagentLaunchModels: [],
+                }, options.config, {
+                    includeModelNotice: true,
+                    deps: options.deps,
+                }),
+                systemPrompt: config.systemPrompt,
+                tools: ToolCatalog.createSubagentRegistry(config.tools, options.backend, config.workingDirectory, options.config, this.jobs.bashJobs, this.jobs.codeJobs, options.history, options.mcp),
+            }),
+            eventSink: async (event) => await this.recordEvent(event),
+            clock: options.deps.clock,
+            archiveAutoCompaction: createAutoCompactionArchiver(options.backend),
+        });
+    }
+    get model() {
+        const { model } = this.config;
+        return {
+            provider: model.provider,
+            id: model.id,
+            reasoning: this.agent.spec.attribution.reasoningEffort,
+        };
+    }
+    get contextWindow() {
+        return this.config.model.contextWindow;
+    }
+    get pendingSteering() {
+        return this.steering.length;
+    }
+    steer(prompt) {
+        this.steering.push({ prompt, submitted: false });
+        this.deliverSteering();
+    }
+    deliverSteering() {
+        if (this.interrupted || this.agent.status !== "running")
+            return;
+        for (const input of this.steering) {
+            if (input.submitted)
+                continue;
+            const submission = this.agent.steer(input.prompt);
+            input.submitted = true;
+            const delivery = submission.applied
+                .then(() => {
+                const index = this.steering.indexOf(input);
+                if (index >= 0)
+                    this.steering.splice(index, 1);
+            }, () => { })
+                .finally(() => this.deliveries.delete(delivery));
+            this.deliveries.add(delivery);
+            void submission.result.catch(() => { });
+        }
+    }
+    async submit(prompt) {
+        this.interrupted = false;
+        this.toolPresentations.clear();
+        this.toolOutcomes.clear();
+        this.blockedToolCalls.clear();
+        let outcome;
+        try {
+            const result = await this.agent.submit(prompt);
+            outcome = this.turnOutcome(result.terminalResult);
+        }
+        catch (error) {
+            outcome = runtimeFailure(error);
+        }
+        finally {
+            await Promise.all(this.deliveries);
+        }
+        const unconsumed = this.interrupted ? [] : this.steering.map((input) => input.prompt);
+        this.steering = [];
+        return { outcome: this.interrupted ? { status: "interrupted" } : outcome, unconsumed };
+    }
+    interrupt() {
+        this.interrupted = true;
+        this.steering = [];
+        this.agent.interrupt();
+    }
+    dispose() {
+        this.interrupt();
+        this.agent.dispose();
+        this.jobs.release();
+    }
+    turnOutcome(result) {
+        if (result.aborted || result.finalMessage?.stopReason === "aborted")
+            return { status: "interrupted" };
+        if (result.blocked)
+            return {
+                status: "failed",
+                failure: { kind: result.blocked.reason, message: result.blocked.message },
+            };
+        if (result.limitReached)
+            return {
+                status: "failed",
+                failure: { kind: result.limitReached.reason, message: result.limitReached.message },
+            };
+        if (!result.finalMessage)
+            return runtimeFailure(new Error("Subagent run completed without a final assistant message."));
+        if (result.finalMessage.stopReason === "error")
+            return {
+                status: "failed",
+                failure: {
+                    kind: "provider-error",
+                    message: result.finalMessage.errorMessage ?? "model returned an unspecified error.",
+                    stopReason: result.finalMessage.stopReason,
+                },
+            };
+        return { status: "succeeded", response: extractAssistantText(result.finalMessage).trim() };
+    }
+    async trace(event) {
+        await this.options.onEvent({ type: "trace", event });
+    }
+    async recordEvent(event) {
+        this.deliverSteering();
+        if (event.type === "tool_call_admitted")
+            await this.trace({
+                kind: "tool_call",
+                callId: event.toolCall.id,
+                toolName: event.toolCall.name,
+                arguments: [{ type: "json", value: JSON.parse(JSON.stringify(event.toolCall.arguments)) }],
+            });
+        if (event.type === "tool_run_finished" || event.type === "tool_run_blocked")
+            this.toolOutcomes.set(event.toolCallId, event.type === "tool_run_blocked" ? "blocked" : event.outcome);
+        const results = event.type === "tool_result"
+            ? [event.message]
+            : event.type === "tool_recovery"
+                ? event.toolResults
+                : [];
+        for (const message of results) {
+            const outcome = this.toolOutcomes.get(message.toolCallId);
+            if (!outcome)
+                throw new Error(`Missing outcome for tool result ${message.toolCallId}`);
+            await this.trace({
+                kind: "tool_result",
+                callId: message.toolCallId,
+                toolName: message.toolName,
+                outcome,
+                content: nativeContent(message.content),
+            });
+            this.toolOutcomes.delete(message.toolCallId);
+        }
+        if (event.type === "compaction_end")
+            await this.trace({ kind: "notice", code: `compaction.${event.outcome}`, content: [] });
+        if (event.type === "assistant_final") {
+            const content = event.message.content.filter((block) => block.type === "text");
+            if (content.length)
+                await this.trace({ kind: "assistant", content: nativeContent(content) });
+            const usage = getUsageTotals(event.message.usage);
+            const cost = getUsageCostTotal(event.message.usage);
+            await this.options.onEvent({
+                type: "usage",
+                entry: {
+                    timestamp: event.message.timestamp,
+                    personaId: event.personaId,
+                    provider: event.message.provider,
+                    model: event.message.model,
+                    api: event.message.api,
+                    reasoningEffort: event.reasoningEffort,
+                    usage,
+                    cost: { total: cost },
+                },
+                contextTokens: usage.input + usage.output + usage.cacheRead + usage.cacheWrite,
+                contextWindow: this.contextWindow,
+            });
+            const text = extractAssistantText(event.message).trim();
+            if (text) {
+                await this.options.onEvent({
+                    type: "activity",
+                    activity: { type: "assistant", text },
+                });
+            }
+            return;
+        }
+        if (event.type === "tool_activity") {
+            this.toolPresentations.set(event.activity.toolCallId, event.activity.presentation);
+            const blockedToolName = this.blockedToolCalls.get(event.activity.toolCallId);
+            if (blockedToolName) {
+                this.blockedToolCalls.delete(event.activity.toolCallId);
+                await this.emitSettledToolActivity(blockedToolName, "blocked", event.activity.presentation);
+                this.toolPresentations.delete(event.activity.toolCallId);
+            }
+            return;
+        }
+        if (event.type === "tool_run_blocked") {
+            const presentation = this.toolPresentations.get(event.toolCallId);
+            if (!presentation) {
+                this.blockedToolCalls.set(event.toolCallId, event.toolName);
+                return;
+            }
+            this.toolPresentations.delete(event.toolCallId);
+            await this.emitSettledToolActivity(event.toolName, "blocked", presentation);
+            return;
+        }
+        if (event.type === "tool_run_finished") {
+            const presentation = this.toolPresentations.get(event.toolCallId);
+            if (!presentation) {
+                throw new Error(`missing presentation for settled tool call '${event.toolCallId}'`);
+            }
+            this.toolPresentations.delete(event.toolCallId);
+            await this.emitSettledToolActivity(event.toolName, event.outcome, presentation);
+            return;
+        }
+        if (event.type === "feedback") {
+            await this.options.onEvent({
+                type: "activity",
+                activity: {
+                    type: "notice",
+                    severity: event.tone === "error" ? "error" : "info",
+                    title: event.title,
+                    ...(event.presentation === "transcript" && event.content
+                        ? { content: event.content }
+                        : {}),
+                },
+            });
+        }
+    }
+    async emitSettledToolActivity(toolName, outcome, presentation) {
+        const { actionByStatus, ...terminalPresentation } = presentation;
+        await this.options.onEvent({
+            type: "activity",
+            activity: {
+                type: "tool",
+                toolName,
+                outcome,
+                presentation: {
+                    action: actionByStatus[outcome],
+                    ...structuredClone(terminalPresentation),
+                },
+            },
+        });
+    }
+}
+//# sourceMappingURL=native_subagent_runtime.js.map

package/dist/core/subagents/native_subagent_runtime.js.map

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

package/dist/core/subagents/prompt.js

@@ -1,7 +1,5 @@
-import { renderSubagentWrapperPrompt } from "../static/index.js";
-export function buildSubagentSystemPrompt(mainPersonaSystemPrompt) {
-    return renderSubagentWrapperPrompt({
-        inheritedInstructions: mainPersonaSystemPrompt,
-    });
+import { renderSubagentPrefixPrompt } from "../static/index.js";
+export function buildSubagentSystemPrompt(systemPrompt, context) {
+    return `${renderSubagentPrefixPrompt(context)}\n\n${systemPrompt}`;
 }
 //# sourceMappingURL=prompt.js.map

package/dist/core/subagents/prompt.js.map

@@ -1 +1 @@
-{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../../src/core/subagents/prompt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAE,MAAM,oBAAoB,CAAC;AAEjE,MAAM,UAAU,yBAAyB,CAAC,uBAA+B;IACvE,OAAO,2BAA2B,CAAC;QACjC,qBAAqB,EAAE,uBAAuB;KAC/C,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../../src/core/subagents/prompt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAEhE,MAAM,UAAU,yBAAyB,CACvC,YAAoB,EACpB,OAA8D;IAE9D,OAAO,GAAG,0BAA0B,CAAC,OAAO,CAAC,OAAO,YAAY,EAAE,CAAC;AACrE,CAAC"}

package/dist/core/subagents/registry.js

@@ -1,4 +1,4 @@
-import { TOOL_NAME_BASH, TOOL_NAME_EDIT, TOOL_NAME_HISTORY, TOOL_NAME_MCP, TOOL_NAME_MODELS, TOOL_NAME_SPAWN_AGENT, TOOL_NAME_VIEW_IMAGE, TOOL_NAME_WEB, TOOL_NAME_WRITE, } from "../tools/tool_names.js";
+import { TOOL_NAME_AGENTS, TOOL_NAME_BASH, TOOL_NAME_EDIT, TOOL_NAME_HISTORY, TOOL_NAME_MCP, TOOL_NAME_MODELS, TOOL_NAME_VIEW_IMAGE, TOOL_NAME_WEB, TOOL_NAME_WRITE, } from "../tools/tool_names.js";
 const INHERITABLE_TOOL_NAMES = new Set([
     TOOL_NAME_BASH,
     TOOL_NAME_WRITE,
@@ -52,7 +52,7 @@ export function resolveSubagentEffectiveSettings(args) {
     };
 }
 export function formatSubagentsForPrompt(persona) {
-    if (!persona.tools.includes(TOOL_NAME_SPAWN_AGENT)) {
+    if (!persona.tools.includes(TOOL_NAME_AGENTS)) {
         return undefined;
     }
     const effective = resolveSubagentEffectiveSettings({ persona });
@@ -64,7 +64,9 @@ export function formatSubagentsForPrompt(persona) {
         "",
         "### Subagents",
         "",
-        "You can spawn general-purpose background subagents to work on independent tasks. Spawn them only when the user or active instructions explicitly request delegation; do not infer authorization from generic task overlap.",
+        "You can start general-purpose background subagents to work on independent tasks. Start them only when the user or active instructions explicitly request delegation; do not infer authorization from generic task overlap.",
+        "",
+        'Start and manage subagents with `tau.agents` in the `code` tool, and read its reference with `tau.docs("agents")` first. It can send a subagent queued or steering input, interrupt it, and read selected parts of its conversation. Use the `wait_for_agents` tool when you want to wait for subagents yourself instead of from a program.',
         "",
         `Inherited model: \`${effective.model.provider}/${effective.model.id}:${reasoning}\``,
         `Allowed model overrides: ${launchModelsText}`,

package/dist/core/subagents/registry.js.map

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

package/dist/core/subagents/runtime.js

@@ -0,0 +1,13 @@
+import { ClaudeCodeRuntime } from "./claude_code_runtime.js";
+import { NativeSubagentRuntime } from "./native_subagent_runtime.js";
+export function createSubagentRuntime(config, options) {
+    return config.kind === "native"
+        ? new NativeSubagentRuntime(config, options)
+        : new ClaudeCodeRuntime({
+            config,
+            backend: options.backend,
+            onEvent: options.onEvent,
+            now: () => options.deps.clock.now(),
+        });
+}
+//# sourceMappingURL=runtime.js.map

package/dist/core/subagents/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../../src/core/subagents/runtime.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAoCrE,MAAM,UAAU,qBAAqB,CACnC,MAA6B,EAC7B,OAA+B;IAE/B,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ;QAC7B,CAAC,CAAC,IAAI,qBAAqB,CAAC,MAAM,EAAE,OAAO,CAAC;QAC5C,CAAC,CAAC,IAAI,iBAAiB,CAAC;YACpB,MAAM;YACN,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,GAAG,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE;SACpC,CAAC,CAAC;AACT,CAAC"}

package/dist/core/subagents/trace.js

@@ -0,0 +1,149 @@
+import { randomUUID } from "node:crypto";
+import { AgentRequestError } from "./errors.js";
+const INLINE_BYTES = 4096;
+const PAGE_CHARS = 16384;
+const RETENTION_BYTES = 64 * 1024 * 1024;
+export class AgentTrace {
+    entries = [];
+    contents = new Map();
+    bytes = 0;
+    sequence = 0;
+    evicted = false;
+    key = randomUUID();
+    append(event, timestamp = Date.now()) {
+        const seq = ++this.sequence;
+        let ref;
+        let retainedBytes = 0;
+        const store = (blocks) => {
+            blocks = boundedTraceBlocks(blocks);
+            const bytes = Buffer.byteLength(JSON.stringify(blocks));
+            if (bytes <= INLINE_BYTES && !blocks.some((block) => block.type === "image")) {
+                return { kind: "inline", blocks: structuredClone(blocks) };
+            }
+            ref = `${this.key}:${seq}`;
+            this.contents.set(ref, structuredClone(blocks));
+            retainedBytes = bytes;
+            return { kind: "reference", ref, bytes };
+        };
+        const entry = {
+            ...event,
+            seq,
+            timestamp,
+            ...("content" in event ? { content: store(event.content) } : {}),
+            ...("arguments" in event ? { arguments: store(event.arguments) } : {}),
+        };
+        const bytes = Buffer.byteLength(JSON.stringify(entry)) + retainedBytes;
+        this.entries.push({ entry, bytes, ref });
+        this.bytes += bytes;
+        while (this.bytes > RETENTION_BYTES || this.entries.length > 4096) {
+            const old = this.entries.shift();
+            this.bytes -= old.bytes;
+            if (old.ref)
+                this.contents.delete(old.ref);
+            this.evicted = true;
+        }
+        return seq;
+    }
+    trace(options) {
+        const query = JSON.stringify([options.kinds ?? null, options.toolName ?? null]);
+        let before = this.sequence + 1;
+        if (options.cursor) {
+            const cursor = this.decode(options.cursor);
+            if (cursor.query !== query || !Number.isInteger(cursor.before))
+                throw new AgentRequestError("invalid_cursor", "Invalid trace cursor");
+            before = cursor.before;
+        }
+        const matching = this.entries.filter(({ entry }) => entry.seq < before &&
+            (!options.kinds || options.kinds.includes(entry.kind)) &&
+            (!options.toolName || ("toolName" in entry && entry.toolName === options.toolName)));
+        const selected = matching.slice(-(options.limit ?? 20));
+        return {
+            entries: structuredClone(selected.map(({ entry }) => entry)),
+            nextCursor: matching.length > selected.length
+                ? this.encode({ query, before: selected[0].entry.seq })
+                : null,
+            historyEvicted: this.evicted,
+        };
+    }
+    readContent(options) {
+        const blocks = this.contents.get(options.ref);
+        if (!blocks)
+            throw new AgentRequestError("expired_content", "Unknown or expired content reference");
+        let index = 0;
+        let offset = 0;
+        if (options.cursor) {
+            const cursor = this.decode(options.cursor);
+            if (cursor.ref !== options.ref ||
+                !Number.isInteger(cursor.index) ||
+                !Number.isInteger(cursor.offset))
+                throw new AgentRequestError("invalid_cursor", "Invalid content cursor");
+            index = cursor.index;
+            offset = cursor.offset;
+        }
+        const block = blocks[index];
+        if (!block || offset < 0 || (block.type === "text" ? offset > block.text.length : offset !== 0))
+            throw new AgentRequestError("invalid_cursor", "Invalid content cursor");
+        let result;
+        if (block.type === "text") {
+            let end = Math.min(offset + PAGE_CHARS, block.text.length);
+            if (end < block.text.length && /[\uD800-\uDBFF]/.test(block.text[end - 1]))
+                end--;
+            result = { type: "text", text: block.text.slice(offset, end) };
+            offset = end;
+            if (end === block.text.length) {
+                index++;
+                offset = 0;
+            }
+        }
+        else {
+            result = structuredClone(block);
+            index++;
+            offset = 0;
+        }
+        return {
+            blocks: [result],
+            nextCursor: index < blocks.length ? this.encode({ ref: options.ref, index, offset }) : null,
+        };
+    }
+    readText(seq, maxChars = 30000) {
+        const entry = this.entries.find((item) => item.entry.seq === seq)?.entry;
+        if (!entry)
+            throw new AgentRequestError("expired_content", "Unknown or expired trace entry");
+        if (entry.kind !== "assistant" && entry.kind !== "tool_result")
+            throw new AgentRequestError("content_type", "Entry is not an assistant message or tool result");
+        const blocks = entry.content.kind === "inline" ? entry.content.blocks : this.contents.get(entry.content.ref);
+        if (!blocks)
+            throw new AgentRequestError("expired_content", "Expired content reference");
+        if (blocks.some((block) => block.type !== "text" && block.type !== "unavailable"))
+            throw new AgentRequestError("content_type", "Mixed content requires readContent");
+        const text = blocks.flatMap((block) => (block.type === "text" ? [block.text] : [])).join("");
+        let end = Math.min(maxChars, text.length);
+        if (end < text.length && /[\uD800-\uDBFF]/.test(text[end - 1]))
+            end--;
+        return {
+            text: text.slice(0, end),
+            complete: end === text.length && !blocks.some((block) => block.type === "unavailable"),
+        };
+    }
+    encode(value) {
+        return Buffer.from(JSON.stringify({ ...value, key: this.key })).toString("base64url");
+    }
+    decode(value) {
+        let cursor;
+        try {
+            cursor = JSON.parse(Buffer.from(value, "base64url").toString("utf8"));
+        }
+        catch {
+            throw new AgentRequestError("invalid_cursor", "Invalid cursor");
+        }
+        if (!cursor || typeof cursor !== "object" || !("key" in cursor) || cursor.key !== this.key)
+            throw new AgentRequestError("invalid_cursor", "Invalid cursor");
+        return cursor;
+    }
+}
+export function boundedTraceBlocks(blocks) {
+    return Buffer.byteLength(JSON.stringify(blocks)) <= 6 * 1024 * 1024
+        ? blocks
+        : [{ type: "unavailable", reason: "Content exceeds the 6 MiB retention limit." }];
+}
+//# sourceMappingURL=trace.js.map

package/dist/core/subagents/trace.js.map

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

package/dist/core/telegram/adapter.js

@@ -771,6 +771,7 @@ class TelegramAdapterImpl {
     projects;
     defaultProjectId;
     systemMessage;
+    personaMenu;
     allowedUserIds;
     allowedChatIds;
     botUsername;
@@ -821,6 +822,7 @@ class TelegramAdapterImpl {
         this.projects = options.projects;
         this.defaultProjectId = options.defaultProjectId;
         this.systemMessage = options.systemMessage?.trim() || undefined;
+        this.personaMenu = options.personaMenu;
         this.allowedUserIds =
             options.allowedUserIds && options.allowedUserIds.length > 0
                 ? new Set(options.allowedUserIds)
@@ -1559,16 +1561,48 @@ class TelegramAdapterImpl {
                 await this.reply(chatId, "the session is still preparing.");
                 return;
             }
-            const personas = snapshot.catalog.personas;
+            const catalog = snapshot.catalog.personas;
+            const currentPersonaId = snapshot.settings.personaId;
+            const menu = this.personaMenu ?? catalog.map((persona) => ({ id: persona.id }));
+            const personas = [];
+            const missingIds = [];
+            for (const entry of menu) {
+                const persona = catalog.find((candidate) => candidate.id === entry.id);
+                if (persona)
+                    personas.push({ id: persona.id, label: entry.label ?? persona.label ?? persona.id });
+                else
+                    missingIds.push(entry.id);
+            }
+            const currentLabel = catalog.find((persona) => persona.id === currentPersonaId)?.label ?? currentPersonaId;
+            const missingText = missingIds.length > 0
+                ? `these personas from this bot's menu aren't available in this session: ${missingIds.join(", ")}.`
+                : undefined;
             if (personas.length === 0) {
-                await this.reply(chatId, "this session has no personas.");
+                if (!this.personaMenu) {
+                    await this.reply(chatId, "this session has no personas.");
+                    return;
+                }
+                const emptyText = this.personaMenu.length === 0
+                    ? "this bot's persona menu is empty, so there are no personas to switch to."
+                    : "none of the personas in this bot's menu are available in this session, so there are no personas to switch to.";
+                const lines = [emptyText, missingText, `this session is using ${currentLabel}.`];
+                await this.reply(chatId, lines.filter(Boolean).join("\n\n"));
                 return;
             }
+            const currentOutsideText = this.personaMenu && !personas.some((persona) => persona.id === currentPersonaId)
+                ? `this session is using ${currentLabel}, which isn't in this menu.`
+                : undefined;
+            const lines = [
+                "choose a persona for this session. switching is available only while Tau is idle.",
+                currentOutsideText,
+                missingText,
+            ];
             this.personaPickers.set(chatId, {
                 token: randomUUID(),
                 sessionId: session.id,
                 personas,
-                currentPersonaId: snapshot.settings.personaId,
+                currentPersonaId,
+                text: lines.filter(Boolean).join("\n\n"),
             });
             await this.showPersonaPage(chatId, 0);
         }
@@ -1583,7 +1617,7 @@ class TelegramAdapterImpl {
         const start = page * 20;
         const keyboard = picker.personas.slice(start, start + 20).map((persona, index) => [
             {
-                text: `${persona.label ?? persona.id}${persona.id === picker.currentPersonaId ? " (current)" : ""}`,
+                text: `${persona.label}${persona.id === picker.currentPersonaId ? " (current)" : ""}`,
                 callback_data: `persona:${picker.token}:select:${start + index}`,
             },
         ]);
@@ -1597,7 +1631,7 @@ class TelegramAdapterImpl {
             navigation.push({ text: "next", callback_data: `persona:${picker.token}:page:${page + 1}` });
         if (navigation.length > 0)
             keyboard.push(navigation);
-        const text = "choose a persona for this session. switching is available only while Tau is idle.";
+        const text = picker.text;
         const replyMarkup = { inline_keyboard: keyboard };
         if (messageId !== undefined) {
             await this.sendWithRetry((signal) => this.api.editMessage(chatId, messageId, text, { replyMarkup, signal }));
@@ -1635,7 +1669,7 @@ class TelegramAdapterImpl {
             return;
         }
         this.personaPickers.delete(chatId);
-        const text = `switched to ${persona.label ?? persona.id}. this session is using ${snapshot.bootstrap.model.name || snapshot.bootstrap.model.id} with ${snapshot.settings.reasoning ?? "none"} reasoning.`;
+        const text = `switched to ${persona.label}. this session is using ${snapshot.bootstrap.model.name || snapshot.bootstrap.model.id} with ${snapshot.settings.reasoning ?? "none"} reasoning.`;
         await this.sendWithRetry((signal) => this.api.editMessage(chatId, messageId, text, { signal }));
     }
     async handlePrompt(chatId, args) {