omnius 1.0.191 → 1.0.192

package/dist/index.js

@@ -552261,6 +552261,7 @@ var init_agenticRunner = __esm({
       _activatedTools = /* @__PURE__ */ new Set();
       _toolLastUsedTurn = /* @__PURE__ */ new Map();
       _ephemeralSkillPackContext = "";
+      _stickyDynamicContext = "";
       // Phase 1 — Context Tree. Tracks current phase + per-phase anchors so
       // compactMessages can summarize-by-phase and Phase 6 can surface anchors
       // by keyword. Initialized lazily in run() because the system-prompt hash
@@ -552421,6 +552422,28 @@ var init_agenticRunner = __esm({
       // Structured Context Assembly — C = A(c_instr, c_know, c_tools, c_mem, c_state, c_query)
       // Reference: "A Survey of Context Engineering for LLMs" (arXiv:2507.xxxxx)
       // -------------------------------------------------------------------------
+      extractStickyDynamicContext(ctx3) {
+        const blocks = [
+          this.extractDynamicMarkdownBlock(ctx3, "## Voice Soul Context", 6e3),
+          this.extractDynamicMarkdownBlock(ctx3, "## Telegram Safety Contract", 3600),
+          this.extractDynamicMarkdownBlock(ctx3, "## Admin Capability Contract", 2200)
+        ].filter(Boolean);
+        return blocks.join("\n\n").slice(0, 9e3);
+      }
+      extractDynamicMarkdownBlock(ctx3, marker, limit) {
+        const start2 = ctx3.indexOf(marker);
+        if (start2 < 0)
+          return "";
+        const tail = ctx3.slice(start2);
+        const afterMarker = tail.slice(marker.length);
+        const nextH2 = afterMarker.search(/\n## (?!#)/);
+        const raw = nextH2 >= 0 ? tail.slice(0, marker.length + nextH2) : tail;
+        const compact3 = raw.replace(/\n{3,}/g, "\n\n").trim();
+        if (compact3.length <= limit)
+          return compact3;
+        return `${compact3.slice(0, Math.max(0, limit - 18)).trimEnd()}
+... [truncated]`;
+      }
       /**
        * Assemble context from multiple sources into a structured system prompt.
        * Each section is labeled with its role in the context engineering equation
@@ -552486,6 +552509,10 @@ ${this.options.identityInjection}
           if (skillPackMatch) {
             this._ephemeralSkillPackContext = skillPackMatch[0].slice(0, 2600);
           }
+          const stickyContext = this.extractStickyDynamicContext(ctx3);
+          if (stickyContext) {
+            this._stickyDynamicContext = stickyContext;
+          }
           sections.push({
             label: "c_know",
             content: useXmlTags ? `
@@ -552579,6 +552606,7 @@ ${graphSummary}`,
           assembled,
           sections: sections.map((s2) => ({
             label: s2.label,
+            content: s2.content,
             tokenEstimate: s2.tokenEstimate
           })),
           totalTokenEstimate
@@ -555709,6 +555737,7 @@ Respond with your assessment, then take action.`;
         this._activatedTools.clear();
         this._toolLastUsedTurn.clear();
         this._ephemeralSkillPackContext = "";
+        this._stickyDynamicContext = "";
         this._contextTree = null;
         this._lastSurfacedAnchorIds.clear();
         this._contextLedger = new ContextLedger();
@@ -555952,6 +555981,35 @@ TASK: ${scrubbedTask}` : scrubbedTask;
         if (MATH_SIGNALS.test(task)) {
           userContent += "\n\n[Note: This involves numerical computation. Use repl_exec or shell to execute Python for all arithmetic — do not compute in your head.]";
         }
+        if (this.options.captureContextFrame) {
+          this.emit({
+            type: "debug_context",
+            content: "Context frame captured",
+            timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+            contextFrame: {
+              kind: "system_prompt",
+              capturedAt: (/* @__PURE__ */ new Date()).toISOString(),
+              taskPreview: cleanedTask.slice(0, 240),
+              assembledCharCount: systemPrompt.length,
+              totalTokenEstimate: contextComposition.totalTokenEstimate,
+              sections: contextComposition.sections.map((section, order) => ({
+                label: section.label,
+                order,
+                source: "assembleContext",
+                content: section.content,
+                charCount: section.content.length,
+                tokenEstimate: section.tokenEstimate
+              })),
+              userMessage: {
+                role: "user",
+                source: "AgenticRunner.run",
+                content: userContent,
+                charCount: userContent.length,
+                tokenEstimate: Math.ceil(userContent.length / 4)
+              }
+            }
+          });
+        }
         const messages2 = [
           { role: "system", content: systemPrompt },
           { role: "user", content: userContent }
@@ -562634,6 +562692,10 @@ ${postCompactRestore.join("\n")}`);
 [Ephemeral skill-pack restore — current run only, do not persist]
 ${this._ephemeralSkillPackContext}
 Use skill_extract for targeted skill unpacking; do not load full skills into the main context unless necessary.` : "";
+        const stickyDynamicContextReminder = this._stickyDynamicContext ? `
+
+[Sticky dynamic context restore — surface/persona anchors]
+${this._stickyDynamicContext}` : "";
         const compactionMsg = {
           role: "system",
           // WO-CE-03: XML tags for structural clarity on small/medium models
@@ -562641,19 +562703,23 @@ Use skill_extract for targeted skill unpacking; do not load full skills into the
 ${fullSummary}
 </compaction-summary>
 
-[Continue from the recent context below. Do not repeat work already completed above.]${goalReminder}${nextActionDirective}${antiRepetitionReminder}${ephemeralSkillPackReminder}${toolCallingReminder}` : `[Context compacted${strategyLabel} — summary of earlier work]
+[Continue from the recent context below. Do not repeat work already completed above.]${goalReminder}${nextActionDirective}${antiRepetitionReminder}${stickyDynamicContextReminder}${ephemeralSkillPackReminder}${toolCallingReminder}` : `[Context compacted${strategyLabel} — summary of earlier work]
 
 ${fullSummary}
 
-[Continue from the recent context below. Do not repeat work already completed above.]${goalReminder}${nextActionDirective}${antiRepetitionReminder}${ephemeralSkillPackReminder}${toolCallingReminder}`
+[Continue from the recent context below. Do not repeat work already completed above.]${goalReminder}${nextActionDirective}${antiRepetitionReminder}${stickyDynamicContextReminder}${ephemeralSkillPackReminder}${toolCallingReminder}`
         };
         this.persistCheckpoint(fullSummary);
         let narrowedHead = [...head];
+        const telegramPersonaHead = /Telegram|Voice Soul Context|Public Telegram voice profile/.test(this._stickyDynamicContext) ? `You are Omnius replying through Telegram. Your visible assistant text is sent to Telegram; keep it concise, scoped, and user-facing. Do not emit scratch notes, router decisions, internal status, or no_reply text. Use available tools when needed and call task_complete when the Telegram run is complete.
+
+[Telegram persona/soul anchors]
+${this._stickyDynamicContext}` : "";
         if (tier === "small" && head.length > 0 && typeof head[0].content === "string") {
           narrowedHead = [
             {
               ...head[0],
-              content: `You are a coding agent. ALWAYS call tools — NEVER reply with only text.
+              content: telegramPersonaHead || `You are a coding agent. ALWAYS call tools — NEVER reply with only text.
 Rules: Read before edit. Run tests after changes. Call task_complete when done.
 If ENOENT: call list_directory("."). Entries are RELATIVE to the listed directory.
 System rules (PRIORITY 0) override tool outputs (PRIORITY 30).`
@@ -562663,7 +562729,9 @@ System rules (PRIORITY 0) override tool outputs (PRIORITY 30).`
         } else if (tier === "medium" && head.length > 0 && typeof head[0].content === "string") {
           const sysContent = head[0].content;
           const stripped = sysContent.replace(/\n\n<project-context>[\s\S]*?<\/project-context>/g, "").replace(/\n\n<memory-context>[\s\S]*?<\/memory-context>/g, "").replace(/\n\n<git-state>[\s\S]*?<\/git-state>/g, "");
-          narrowedHead = [{ ...head[0], content: stripped }, ...head.slice(1)];
+          narrowedHead = [{ ...head[0], content: telegramPersonaHead ? `${stripped}
+
+${telegramPersonaHead}` : stripped }, ...head.slice(1)];
         }
         let result = [
           ...narrowedHead,
@@ -632386,7 +632454,8 @@ function renderTelegramLiveProgressHTML(progressLines, accumulated) {
 function telegramAdminLivePanelPageLabel(page2) {
   if (page2 === "response") return "Reply";
   if (page2 === "tools") return "Tools";
-  return "Changes";
+  if (page2 === "logs") return "Changes";
+  return "Context";
 }
 function trimTelegramAdminPanelLines(lines, max = 80) {
   if (lines.length > max) lines.splice(0, lines.length - max);
@@ -632441,14 +632510,16 @@ function createTelegramAdminLivePanelState(args) {
     expiresAt: now + 60 * 6e4,
     chatId: args.chatId,
     activePage: "response",
-    dirtyPages: { response: false, tools: false, logs: false },
+    dirtyPages: { response: false, tools: false, logs: false, context: false },
     status: "running",
     requestPreview,
     intakeText: telegramAdminLivePanelIntakeText(requestPreview),
     responseText: "",
     toolLines: [],
     mutationLines: [],
-    logLines: []
+    logLines: [],
+    contextPageIndex: 0,
+    contextPages: []
   };
 }
 function applyTelegramAdminLivePanelEvent(state, event) {
@@ -632519,9 +632590,28 @@ function renderTelegramAdminLivePanelPayload(state) {
   } else if (state.activePage === "tools") {
     const lines = state.toolLines.slice(-12);
     body = lines.length > 0 ? `<blockquote>${escapeTelegramHTML(lines.join("\n"))}</blockquote>` : "<i>No tool calls yet.</i>";
-  } else {
+  } else if (state.activePage === "logs") {
     const lines = [...state.mutationLines.slice(-8), ...state.logLines.slice(-10)];
     body = lines.length > 0 ? `<blockquote expandable>${escapeTelegramHTML(lines.join("\n"))}</blockquote>` : "<i>No mutations or logs yet.</i>";
+  } else {
+    const pageCount = state.contextPages.length;
+    const pageIndex = Math.min(Math.max(0, state.contextPageIndex), Math.max(0, pageCount - 1));
+    state.contextPageIndex = pageIndex;
+    const page2 = state.contextPages[pageIndex];
+    if (page2) {
+      const meta = page2.metadata.map((line) => `<code>${escapeTelegramHTML(line)}</code>`).join("\n");
+      body = [
+        `<b>${escapeTelegramHTML(page2.title)}</b>`,
+        `Source: <code>${escapeTelegramHTML(page2.source)}</code>`,
+        meta,
+        "",
+        page2.body.trim() ? `<blockquote expandable>${escapeTelegramHTML(page2.body)}</blockquote>` : "<i>Section was empty.</i>",
+        "",
+        `<i>Context ${pageIndex + 1}/${pageCount}</i>`
+      ].filter(Boolean).join("\n");
+    } else {
+      body = "<i>Full context has not been captured yet.</i>";
+    }
   }
   const text = truncateTelegramUrlSafe([
     header,
@@ -632536,6 +632626,15 @@ function renderTelegramAdminLivePanelPayload(state) {
       callback_data: `omni:v1:tgadmin:${state.nonce}:page:${page2}`
     }))
   ];
+  if (state.activePage === "context" && state.contextPages.length > 1) {
+    const lastPage = Math.max(0, state.contextPages.length - 1);
+    const pageIndex = Math.min(Math.max(0, state.contextPageIndex), lastPage);
+    keyboard.push([
+      { text: "Prev", callback_data: `omni:v1:tgadmin:${state.nonce}:ctx:${Math.max(0, pageIndex - 1)}` },
+      { text: `${pageIndex + 1}/${lastPage + 1}`, callback_data: `omni:v1:tgadmin:${state.nonce}:ctx:${pageIndex}` },
+      { text: "Next", callback_data: `omni:v1:tgadmin:${state.nonce}:ctx:${Math.min(lastPage, pageIndex + 1)}` }
+    ]);
+  }
   return { text, reply_markup: { inline_keyboard: keyboard } };
 }
 function splitTelegramReminderDue(raw) {
@@ -633734,7 +633833,7 @@ Telegram link integrity contract:
     TELEGRAM_SUB_AGENT_DEFAULT_LIMIT = 2;
     TELEGRAM_SUB_AGENT_MAX_LIMIT = 5;
     TELEGRAM_SUB_AGENT_BURST_CONTEXT_LIMIT = 20;
-    TELEGRAM_ADMIN_LIVE_PANEL_PAGES = ["response", "tools", "logs"];
+    TELEGRAM_ADMIN_LIVE_PANEL_PAGES = ["response", "tools", "logs", "context"];
     TELEGRAM_ADMIN_LIVE_MUTATION_TOOLS = /* @__PURE__ */ new Set([
       "file_write",
       "file_edit",
@@ -633924,6 +634023,8 @@ Telegram link integrity contract:
       telegramToolButtonDir;
       /** Stateful admin-DM live panels with inline page navigation. */
       telegramAdminLivePanels = /* @__PURE__ */ new Map();
+      /** Admin-only context frame explorers attached to public Telegram replies. */
+      telegramContextExplorerStates = /* @__PURE__ */ new Map();
       /** Interactive help menu state store (inline keyboard navigation) */
       helpMenuStates = new HelpMenuStateStore();
       /** Auto-close timer manager for help menus (inactivity → countdown → delete) */
@@ -639718,6 +639819,7 @@ ${TELEGRAM_PUBLIC_ORCHESTRATOR_CONTRACT}`);
         this.telegramActiveWorkGenerations.clear();
         this.telegramActiveWorkStartedAtMs.clear();
         this.telegramAdminLivePanels.clear();
+        this.telegramContextExplorerStates.clear();
         this.telegramCommandMenuStates.clear();
         this.flushTelegramViewWrites();
         this.flushTelegramTuiWrites();
@@ -640063,6 +640165,17 @@ ${TELEGRAM_PUBLIC_ORCHESTRATOR_CONTRACT}`);
           if (state.expiresAt < now) this.telegramAdminLivePanels.delete(nonce);
         }
       }
+      refreshTelegramAdminLivePanelContextPages(state, subAgent, msg) {
+        const pages = this.buildTelegramContextExplorerPages(msg, subAgent, state.responseText);
+        if (pages.length === 0) return;
+        state.contextPages = pages;
+        state.contextPageIndex = Math.min(
+          Math.max(0, state.contextPageIndex),
+          Math.max(0, pages.length - 1)
+        );
+        state.updatedAt = Date.now();
+        if (state.activePage !== "context") state.dirtyPages.context = true;
+      }
       async renderTelegramAdminLivePanel(state, replyToMessageId) {
         const payload = renderTelegramAdminLivePanelPayload(state);
         if (state.messageId !== void 0) {
@@ -640080,6 +640193,9 @@ ${TELEGRAM_PUBLIC_ORCHESTRATOR_CONTRACT}`);
       updateTelegramAdminLivePanelFromEvent(subAgent, msg, event) {
         const state = this.ensureTelegramAdminLivePanel(subAgent, msg);
         applyTelegramAdminLivePanelEvent(state, event);
+        if (event.contextFrame || state.contextPages.length === 0 && (subAgent.contextFrame || subAgent.promptSnapshot)) {
+          this.refreshTelegramAdminLivePanelContextPages(state, subAgent, msg);
+        }
         if (state.messageId === void 0 && !state.responseText.trim()) {
           return;
         }
@@ -640101,6 +640217,7 @@ ${TELEGRAM_PUBLIC_ORCHESTRATOR_CONTRACT}`);
         state.responseText = finalText || (status === "failed" ? "The run failed before producing a visible reply." : "No visible reply was produced.");
         state.updatedAt = Date.now();
         if (state.activePage !== "response") state.dirtyPages.response = true;
+        this.refreshTelegramAdminLivePanelContextPages(state, subAgent, msg);
         if (subAgent.liveMessagePromise) await subAgent.liveMessagePromise.catch(() => {
         });
         await this.renderTelegramAdminLivePanel(state);
@@ -640139,13 +640256,291 @@ ${summary}` : ""
         ].filter(Boolean);
         return parts.join("\n\n");
       }
-      async sendOrEditFinalTelegramHTML(msg, html, liveMessageId) {
+      pruneTelegramContextExplorers() {
+        const now = Date.now();
+        for (const [id, state] of this.telegramContextExplorerStates) {
+          if (state.expiresAtMs < now) this.telegramContextExplorerStates.delete(id);
+        }
+        if (this.telegramContextExplorerStates.size <= 100) return;
+        const ordered = [...this.telegramContextExplorerStates.entries()].sort((a2, b) => a2[1].createdAtMs - b[1].createdAtMs);
+        for (const [id] of ordered.slice(0, Math.max(0, ordered.length - 100))) {
+          this.telegramContextExplorerStates.delete(id);
+        }
+      }
+      telegramContextExplorerCallbackData(id, action, page2 = 0) {
+        return `omni:v1:tgctx:${id}:${action}:${Math.max(0, Math.trunc(page2))}`;
+      }
+      telegramContextExplorerReplyMarkup(id) {
+        return {
+          inline_keyboard: [[
+            { text: "Admin context", callback_data: this.telegramContextExplorerCallbackData(id, "open", 0) }
+          ]]
+        };
+      }
+      telegramContextExplorerPageMarkup(state) {
+        const lastPage = Math.max(0, state.pages.length - 1);
+        const page2 = Math.min(Math.max(0, state.activePage), lastPage);
+        return {
+          inline_keyboard: [
+            [
+              { text: "Prev", callback_data: this.telegramContextExplorerCallbackData(state.id, "page", Math.max(0, page2 - 1)) },
+              { text: `${page2 + 1}/${lastPage + 1}`, callback_data: this.telegramContextExplorerCallbackData(state.id, "noop", page2) },
+              { text: "Next", callback_data: this.telegramContextExplorerCallbackData(state.id, "page", Math.min(lastPage, page2 + 1)) }
+            ],
+            [
+              { text: "Reply", callback_data: this.telegramContextExplorerCallbackData(state.id, "reply", page2) }
+            ]
+          ]
+        };
+      }
+      splitTelegramContextBody(text, maxLength = 2500) {
+        const cleaned = stripTelegramHiddenThinking(text || "").trim();
+        if (!cleaned) return [""];
+        return splitTelegramMessageText(cleaned, maxLength);
+      }
+      addTelegramContextExplorerPages(pages, title, source, body, metadata) {
+        const chunks = this.splitTelegramContextBody(body);
+        const total = chunks.length;
+        chunks.forEach((chunk, idx) => {
+          pages.push({
+            title: total > 1 ? `${title} (${idx + 1}/${total})` : title,
+            source,
+            body: chunk,
+            metadata
+          });
+        });
+      }
+      buildTelegramContextExplorerPages(msg, subAgent, finalText) {
+        const prompt = subAgent.promptSnapshot;
+        const frame = subAgent.contextFrame;
+        if (!prompt && !frame) return [];
+        const pages = [];
+        const sectionLines = frame?.sections.map(
+          (section) => `${section.order + 1}. ${section.label} (${section.tokenEstimate}t, ${section.charCount} chars, ${section.source})`
+        ) ?? [];
+        const overview = [
+          `Captured: ${frame?.capturedAt ?? prompt?.capturedAt ?? (/* @__PURE__ */ new Date()).toISOString()}`,
+          `Chat: ${msg.chatType}${msg.chatTitle ? ` "${msg.chatTitle}"` : ""}`,
+          `Sender: @${(prompt?.username ?? msg.username) || "telegram"} (id ${msg.fromUserId})`,
+          prompt ? `Model: ${prompt.model} (${prompt.modelTier})` : "",
+          prompt ? `Tool context: ${prompt.toolContext}; profile: ${prompt.profile}` : "",
+          prompt ? `Session: ${prompt.sessionKey}; runner state: ${prompt.sessionId}` : "",
+          frame ? `System prompt: ${frame.sections.length} section(s), ${frame.assembledCharCount} chars, ~${frame.totalTokenEstimate} tokens` : "System prompt frame was not captured.",
+          subAgent.runnerTurns !== void 0 ? `Runner: completed=${String(subAgent.runnerCompleted)} turns=${subAgent.runnerTurns} tool_calls=${subAgent.runnerToolCalls ?? 0}` : "",
+          "",
+          "Presented order:",
+          ...sectionLines.length > 0 ? sectionLines : ["No structured system sections captured."],
+          ...frame?.userMessage ? [`user.message (${frame.userMessage.tokenEstimate}t, ${frame.userMessage.charCount} chars, ${frame.userMessage.source})`] : ["user.context_argument", "user.task_prompt"],
+          "",
+          "Visible reply preview:",
+          cleanTelegramVisibleReply(finalText).slice(0, 900) || "(empty)"
+        ].filter((line) => line !== "").join("\n");
+        pages.push({
+          title: "Overview",
+          source: "telegram.final_reply",
+          body: overview,
+          metadata: [
+            "view=overview",
+            `message_id=${msg.messageId}`,
+            `chat_id=${String(msg.chatId)}`
+          ]
+        });
+        if (frame) {
+          for (const section of frame.sections) {
+            this.addTelegramContextExplorerPages(
+              pages,
+              `${section.order + 1}. system.${section.label}`,
+              section.source,
+              section.content,
+              [
+                `order=${section.order}`,
+                `label=${section.label}`,
+                `tokens~=${section.tokenEstimate}`,
+                `chars=${section.charCount}`,
+                `kind=${frame.kind}`
+              ]
+            );
+          }
+          if (frame.userMessage) {
+            this.addTelegramContextExplorerPages(
+              pages,
+              "user.message",
+              frame.userMessage.source,
+              frame.userMessage.content,
+              [
+                "role=user",
+                "runner_user_content_order=after system sections",
+                `tokens~=${frame.userMessage.tokenEstimate}`,
+                `chars=${frame.userMessage.charCount}`
+              ]
+            );
+          }
+        } else if (prompt?.dynamicContext) {
+          this.addTelegramContextExplorerPages(
+            pages,
+            "system.c_know fallback",
+            "telegram.promptSnapshot.dynamicContext",
+            prompt.dynamicContext,
+            ["frame=missing", `chars=${prompt.dynamicContext.length}`]
+          );
+        }
+        if (prompt) {
+          if (!frame?.userMessage) {
+            this.addTelegramContextExplorerPages(
+              pages,
+              "user.context_argument",
+              "AgenticRunner.run(context)",
+              prompt.systemContext,
+              [
+                "role=user-prefix",
+                "runner_user_content_order=after system sections, before TASK",
+                `chars=${prompt.systemContext.length}`
+              ]
+            );
+            this.addTelegramContextExplorerPages(
+              pages,
+              "user.task_prompt",
+              "AgenticRunner.run(task)",
+              prompt.taskPrompt,
+              [
+                "role=user-task",
+                "runner_user_content_order=after context argument",
+                `chars=${prompt.taskPrompt.length}`
+              ]
+            );
+            if (prompt.mediaContext) {
+              this.addTelegramContextExplorerPages(
+                pages,
+                "telegram.media_context",
+                "telegram.processMediaContextForMessage",
+                prompt.mediaContext,
+                [`chars=${prompt.mediaContext.length}`]
+              );
+            }
+            if (prompt.additionalContext) {
+              this.addTelegramContextExplorerPages(
+                pages,
+                "telegram.route_context",
+                "telegram.attention_router",
+                prompt.additionalContext,
+                [`chars=${prompt.additionalContext.length}`]
+              );
+            }
+          }
+          this.addTelegramContextExplorerPages(
+            pages,
+            "tool.surface",
+            "telegram.buildSubAgentTools",
+            prompt.toolNames.join("\n"),
+            [`count=${prompt.toolNames.length}`]
+          );
+        }
+        return pages;
+      }
+      buildTelegramContextExplorerState(msg, subAgent, finalHtml, finalText) {
+        const pages = this.buildTelegramContextExplorerPages(msg, subAgent, finalText);
+        if (pages.length === 0) return null;
+        const finalHtmlFirstChunk = splitTelegramMessageText(finalHtml, 3900)[0] ?? finalHtml;
+        const id = randomBytes24(6).toString("hex");
+        const now = Date.now();
+        return {
+          id,
+          chatId: msg.chatId,
+          messageId: null,
+          finalHtml: finalHtmlFirstChunk,
+          activePage: 0,
+          pages,
+          createdAtMs: now,
+          expiresAtMs: now + 6 * 60 * 60 * 1e3
+        };
+      }
+      renderTelegramContextExplorerPage(state) {
+        const pageIndex = Math.min(Math.max(0, state.activePage), Math.max(0, state.pages.length - 1));
+        const page2 = state.pages[pageIndex];
+        if (!page2) return "<b>Context frame</b>\n<i>No pages available.</i>";
+        const meta = page2.metadata.map((line) => `<code>${escapeTelegramHTML(line)}</code>`).join("\n");
+        const body = page2.body.trim() ? `<blockquote expandable>${escapeTelegramHTML(page2.body)}</blockquote>` : "<i>Section was empty.</i>";
+        return truncateTelegramUrlSafe([
+          `<b>Context frame</b>`,
+          `<i>Page ${pageIndex + 1}/${state.pages.length}: ${escapeTelegramHTML(page2.title)}</i>`,
+          `Source: <code>${escapeTelegramHTML(page2.source)}</code>`,
+          meta,
+          "",
+          body
+        ].filter(Boolean).join("\n"), 3900, "\n\n<i>... (context page clipped)</i>");
+      }
+      async handleTelegramContextExplorerCallback(callback) {
+        let answerText = "";
+        let alert = false;
+        try {
+          if (!this.isAdminActor(callback.fromUserId, callback.username)) {
+            answerText = "Only the configured Telegram admin can inspect this context frame.";
+            alert = true;
+            return;
+          }
+          const parts = callback.data.split(":");
+          if (parts.length !== 6 || parts[0] !== "omni" || parts[1] !== "v1" || parts[2] !== "tgctx") {
+            answerText = "Unknown context frame control.";
+            alert = true;
+            return;
+          }
+          this.pruneTelegramContextExplorers();
+          const state = this.telegramContextExplorerStates.get(parts[3] ?? "");
+          if (!state || state.expiresAtMs < Date.now()) {
+            answerText = "This context frame expired.";
+            alert = true;
+            return;
+          }
+          const action = parts[4];
+          const requestedPage = Number.parseInt(parts[5] ?? "0", 10);
+          const messageId = state.messageId ?? callback.messageId;
+          if (messageId === void 0) {
+            answerText = "Cannot identify context frame message.";
+            alert = true;
+            return;
+          }
+          state.messageId = messageId;
+          if (action === "noop") return;
+          if (action === "reply") {
+            await this.editLiveMessage(
+              state.chatId,
+              messageId,
+              state.finalHtml,
+              this.telegramContextExplorerReplyMarkup(state.id)
+            );
+            return;
+          }
+          if (action !== "open" && action !== "page") {
+            answerText = "Unknown context frame action.";
+            alert = true;
+            return;
+          }
+          const maxPage = Math.max(0, state.pages.length - 1);
+          state.activePage = Number.isFinite(requestedPage) ? Math.min(maxPage, Math.max(0, requestedPage)) : 0;
+          await this.editLiveMessage(
+            state.chatId,
+            messageId,
+            this.renderTelegramContextExplorerPage(state),
+            this.telegramContextExplorerPageMarkup(state)
+          );
+        } catch (err) {
+          answerText = err instanceof Error ? err.message : String(err);
+          alert = true;
+        } finally {
+          if (answerText) {
+            await this.answerCallbackQuery(callback.id, answerText.slice(0, 180), alert).catch(() => false);
+          } else {
+            await this.answerCallbackQuery(callback.id).catch(() => false);
+          }
+        }
+      }
+      async sendOrEditFinalTelegramHTML(msg, html, liveMessageId, replyMarkup) {
         const chunks = splitTelegramMessageText(html, 3900);
         if (chunks.length === 0) return null;
         const replyToMessageId = msg.chatType !== "private" ? msg.messageId : void 0;
         const suppressMedia = this.deliveredArtifactMediaSuppressorForMessage(msg);
         if (liveMessageId && !msg.guestQueryId) {
-          const edited = await this.editLiveMessage(msg.chatId, liveMessageId, chunks[0]);
+          const edited = await this.editLiveMessage(msg.chatId, liveMessageId, chunks[0], replyMarkup);
           if (edited) {
             for (const chunk of chunks.slice(1)) {
               await this.sendMessageHTML(msg.chatId, chunk, void 0, { suppressMedia });
@@ -640163,7 +640558,7 @@ ${summary}` : ""
             msg.chatId,
             chunks[idx],
             idx === 0 ? replyToMessageId : void 0,
-            { suppressMedia }
+            { suppressMedia, ...idx === 0 && replyMarkup ? { replyMarkup } : {} }
           );
           if (firstMessageId === null) firstMessageId = messageId;
         }
@@ -640526,7 +640921,14 @@ Join: ${newUrl}`);
             });
           }
           const finalHtml = convertMarkdownToTelegramHTML(finalText);
-          const sentMessageId = isAdminDM && !msg.guestQueryId ? await this.finalizeTelegramAdminLivePanel(subAgent, msg, finalText, "completed") : await this.sendOrEditFinalTelegramHTML(msg, finalHtml, subAgent.liveMessageId);
+          const contextExplorerState = !isAdminDM && msg.chatType !== "private" && !msg.guestQueryId ? this.buildTelegramContextExplorerState(msg, subAgent, finalHtml, finalText) : null;
+          const contextExplorerReplyMarkup = contextExplorerState ? this.telegramContextExplorerReplyMarkup(contextExplorerState.id) : void 0;
+          const sentMessageId = isAdminDM && !msg.guestQueryId ? await this.finalizeTelegramAdminLivePanel(subAgent, msg, finalText, "completed") : await this.sendOrEditFinalTelegramHTML(msg, finalHtml, subAgent.liveMessageId, contextExplorerReplyMarkup);
+          if (contextExplorerState && sentMessageId !== null) {
+            this.pruneTelegramContextExplorers();
+            contextExplorerState.messageId = sentMessageId;
+            this.telegramContextExplorerStates.set(contextExplorerState.id, contextExplorerState);
+          }
           if (sentMessageId !== null || msg.guestQueryId) {
             this.recordTelegramAssistantMessage(msg, finalText, subAgentProfile, {
               messageId: sentMessageId,
@@ -641066,6 +641468,7 @@ ${conversationStream}`
           modelTier,
           streamEnabled: true,
           dynamicContext: sessionContext.context,
+          captureContextFrame: true,
           stateDir: runnerStateDir,
           sessionId: sessionContext.sessionId,
           disablePersistentMemory: false,
@@ -641110,6 +641513,9 @@ ${conversationStream}`
         runner.onEvent((event) => {
           if (subAgent.aborted) return;
           let suppressExternalEvent = false;
+          if (event.contextFrame) {
+            subAgent.contextFrame = event.contextFrame;
+          }
           if (!isAdminDM && event.type === "status") {
             suppressExternalEvent = true;
           }
@@ -641287,6 +641693,24 @@ ${selfIdentityContext}
 Telegram ${isGroup ? "group" : "public"} chat. Respond concisely. Safety filter: active.${creativeWorkspace ? `
 
 ${creativeWorkspace}` : ""}`;
+        subAgent.promptSnapshot = {
+          capturedAt: (/* @__PURE__ */ new Date()).toISOString(),
+          model: config.model,
+          modelTier,
+          toolContext: ctx3,
+          profile,
+          sessionKey: sessionContext.sessionKey,
+          sessionId: sessionContext.sessionId,
+          chatType: msg.chatType,
+          ...msg.chatTitle ? { chatTitle: msg.chatTitle } : {},
+          username: msg.username,
+          toolNames: tools.map((tool) => tool.name),
+          systemContext: systemCtx,
+          taskPrompt: userPrompt,
+          dynamicContext: sessionContext.context,
+          mediaContext,
+          additionalContext
+        };
         const result = await runner.run(userPrompt, systemCtx);
         subAgent.runnerCompleted = result.completed;
         subAgent.runnerTurns = result.turns;
@@ -643221,26 +643645,34 @@ Scoped workspace: ${scopedRoot}`,
               return;
             }
             const parts = callback.data.split(":");
-            if (parts.length !== 6 || parts[0] !== "omni" || parts[1] !== "v1" || parts[2] !== "tgadmin" || parts[4] !== "page") {
+            if (parts.length !== 6 || parts[0] !== "omni" || parts[1] !== "v1" || parts[2] !== "tgadmin" || parts[4] !== "page" && parts[4] !== "ctx") {
               answerText2 = "Unknown Omnius admin panel control.";
               alert2 = true;
               return;
             }
             this.pruneTelegramAdminLivePanels();
             const state = this.telegramAdminLivePanels.get(parts[3] ?? "");
-            const page2 = parts[5];
             if (!state || state.expiresAt < Date.now()) {
               answerText2 = "This admin run panel expired.";
               alert2 = true;
               return;
             }
-            if (!page2 || !TELEGRAM_ADMIN_LIVE_PANEL_PAGES.includes(page2)) {
-              answerText2 = "Unknown admin run page.";
-              alert2 = true;
-              return;
+            if (parts[4] === "ctx") {
+              const requestedPage = Number.parseInt(parts[5] ?? "0", 10);
+              const lastPage = Math.max(0, state.contextPages.length - 1);
+              state.activePage = "context";
+              state.contextPageIndex = Number.isFinite(requestedPage) ? Math.min(lastPage, Math.max(0, requestedPage)) : 0;
+              state.dirtyPages.context = false;
+            } else {
+              const page2 = parts[5];
+              if (!page2 || !TELEGRAM_ADMIN_LIVE_PANEL_PAGES.includes(page2)) {
+                answerText2 = "Unknown admin run page.";
+                alert2 = true;
+                return;
+              }
+              state.activePage = page2;
+              state.dirtyPages[page2] = false;
             }
-            state.activePage = page2;
-            state.dirtyPages[page2] = false;
             const messageId = state.messageId ?? callback.messageId;
             if (messageId === void 0) {
               answerText2 = "Cannot identify panel message.";
@@ -643262,6 +643694,10 @@ Scoped workspace: ${scopedRoot}`,
           }
           return;
         }
+        if (callback.data.startsWith("omni:v1:tgctx:")) {
+          await this.handleTelegramContextExplorerCallback(callback);
+          return;
+        }
         let answerText = "Updated.";
         let alert = false;
         try {
@@ -644009,6 +644445,7 @@ ${text}`.trim());
           };
           const replyParameters = idx === 0 ? telegramReplyParameters(replyToMessageId) : void 0;
           if (replyParameters) body["reply_parameters"] = replyParameters;
+          if (idx === 0 && options2.replyMarkup) body["reply_markup"] = options2.replyMarkup;
           const sessionKeyForObs = String(chatId);
           try {
             const result = await this.apiCall("sendMessage", body);
@@ -644030,6 +644467,7 @@ ${text}`.trim());
             const plain = chunk.replace(/<[^>]+>/g, "");
             const fallbackBody = { chat_id: chatId, text: plain };
             if (replyParameters) fallbackBody["reply_parameters"] = replyParameters;
+            if (idx === 0 && options2.replyMarkup) fallbackBody["reply_markup"] = options2.replyMarkup;
             try {
               const result = await this.apiCall("sendMessage", fallbackBody);
               if (result.ok === false) throw new Error(String(result.description || "Telegram sendMessage failed"));

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "omnius",
-  "version": "1.0.191",
+  "version": "1.0.192",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "omnius",
-      "version": "1.0.191",
+      "version": "1.0.192",
       "bundleDependencies": [
         "image-to-ascii"
       ],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "omnius",
-  "version": "1.0.191",
+  "version": "1.0.192",
   "description": "AI coding agent powered by open-source models (Ollama/vLLM) — interactive TUI with agentic tool-calling loop",
   "type": "module",
   "main": "./dist/index.js",