Help:Ephemera Agent/Browser: Difference between revisions

Latest revision as of 19:17, 9 April 2026

Overview

The BROWSER tab is an integrated wiki reader. Switch to it with the BROWSER button in the header bar, or the agent switches to it automatically after completing a generative task.

Preview Mode

Fetches the page via the MediaWiki parse API and renders it as HTML. Internal links are intercepted — clicking them loads the target in the preview pane. External links open in a new tab.

Diff Mode

Shows a line-by-line diff of the two most recent revisions of the current page. Unchanged sections are collapsed to three lines of context. Colour coding: green = added, red = removed, grey = context.

After any agent edit, the diff is pre-computed and ready — switch to DIFF to see exactly what changed.

Search

The search bar queries your wiki via the MediaWiki search API. Results appear as a clickable dropdown. Press Enter or click SEARCH.

Back Button

◀ BACK walks back through pages visited during the current session.

+ CONTEXT Button

A + CONTEXT button appears in the browser toolbar whenever a page is loaded. Clicking it adds the current page to the custom context package — a set of pages force-included in the context assembly for subsequent agent tasks.

The button flashes ✓ ADDED on success. Added pages appear under CUSTOM PAGES in the Context tab and are included in every agent call until cleared.

Red Link AutoGen

When Enable red link detection is checked in the Settings tab, red links in the preview pane get a dashed underline and ⚡ cursor.

Title Resolution

The system reads the true target page title from the MediaWiki link element (not the display text). This ensures piped links like [[Source:Annual Report 2045|source]] correctly target Source:Annual Report 2045, not the word "source".

Source Routing

If a red link's target title begins with Source:, the system automatically uses the source page type for generation — overriding the Page Type setting for that link only. All other links use the Page Type selector.

Click to Generate

Click any red link to trigger the agent to create that page. The generated page loads in the browser automatically. Enables a "wiki rabbit hole" — the wiki expands as you browse.

Batch Generation

When red links are present, a batch button appears in the browser toolbar:

⚡ Generate N red links — full articles (green button)
⚡ Stub N red links — minimal stubs (blue button, shown when Article Depth = Stub)

The batch button colour and label update automatically to match the current Article Depth setting.

Clicking it processes all red links sequentially (1-second pause between each). When complete, the source page reloads — previously red links are now blue.

Article Depth and Stub Mode

In the Settings tab, Article Depth controls what each red link generates:

Full article: Generates a complete encyclopedia entry. After generation, the browser shows the new page.

Stub only: Generates a minimal stub (section headers, 1–3 sentences per section, {{stub}} tag). After generation, the Context tab opens with the stub pre-loaded for review or expansion.

See Help:Ephemera Agent/Stub Workflow for the full stub → expand lifecycle.

@@ Line 4: / Line 4: @@
 == Overview ==
-The '''BROWSER''' view is an integrated wiki browser with two display modes. Switch to it using the '''BROWSER''' button in the header, or the agent switches to it automatically after editing a page.
+The '''BROWSER''' tab is an integrated wiki reader. Switch to it with the '''BROWSER''' button in the header bar, or the agent switches to it automatically after completing a generative task.
 == Preview Mode ==
-Fetches the page from the wiki using the MediaWiki parse API and renders it as HTML. Internal wiki links are intercepted — clicking them loads the linked page in the preview pane instead of navigating away. External links open in a new tab.
+Fetches the page via the MediaWiki parse API and renders it as HTML. Internal links are intercepted — clicking them loads the target in the preview pane. External links open in a new tab.
-After any successful agent edit, the tool automatically switches to BROWSER/PREVIEW and loads the updated page.
 == Diff Mode ==
-Shows a line-by-line diff of the two most recent revisions of the current page. Unchanged sections are collapsed to 3 lines of context around each change.
+Shows a line-by-line diff of the two most recent revisions of the current page. Unchanged sections are collapsed to three lines of context. Colour coding: green = added, red = removed, grey = context.
-After an agent edit, the diff is pre-computed and ready immediately — switch to the DIFF tab to see exactly what changed.
+After any agent edit, the diff is pre-computed and ready — switch to DIFF to see exactly what changed.
-Colour coding:
-* Green (<code>+</code>) — added lines
-* Red (<code>-</code>) — removed lines
-* Grey — context lines
 == Search ==
-The search bar at the top of the browser panel searches your wiki using the MediaWiki search API and shows results as a clickable dropdown. Click any result to load it in preview. Press <kbd>Enter</kbd> or click '''SEARCH'''.
+The search bar queries your wiki via the MediaWiki search API. Results appear as a clickable dropdown. Press <kbd>Enter</kbd> or click '''SEARCH'''.
 == Back Button ==
-The '''◀ BACK''' button walks back through pages you've visited in the browser during the current session. Each page you navigate to is pushed onto a session history stack.
+'''◀ BACK''' walks back through pages visited during the current session.
+== + CONTEXT Button ==
+A '''+ CONTEXT''' button appears in the browser toolbar whenever a page is loaded. Clicking it adds the current page to the '''custom context package''' — a set of pages force-included in the context assembly for subsequent agent tasks.
+The button flashes '''✓ ADDED''' on success. Added pages appear under '''CUSTOM PAGES''' in the Context tab and are included in every agent call until cleared.
 == Red Link AutoGen ==
-When '''Enable red link detection''' is on in the Settings tab, red links in the preview pane are highlighted with a dashed red underline and a ⚡ indicator.
+When '''Enable red link detection''' is checked in the Settings tab, red links in the preview pane get a dashed underline and ⚡ cursor.
+=== Title Resolution ===
+The system reads the true target page title from the MediaWiki link element (not the display text). This ensures piped links like <code><nowiki>[[Source:Annual Report 2045|source]]</nowiki></code> correctly target <code>Source:Annual Report 2045</code>, not the word "source".
+=== Source Routing ===
+If a red link's target title begins with <code>Source:</code>, the system automatically uses the '''source''' page type for generation — overriding the Page Type setting for that link only. All other links use the Page Type selector.
+=== Click to Generate ===
+Click any red link to trigger the agent to create that page. The generated page loads in the browser automatically. Enables a "wiki rabbit hole" — the wiki expands as you browse.
+=== Batch Generation ===
+When red links are present, a batch button appears in the browser toolbar:
+* '''⚡ Generate N red links''' — full articles (green button)
+* '''⚡ Stub N red links''' — minimal stubs (blue button, shown when Article Depth = Stub)
+The batch button colour and label update automatically to match the current Article Depth setting.
+Clicking it processes all red links sequentially (1-second pause between each). When complete, the source page reloads — previously red links are now blue.
+=== Article Depth and Stub Mode ===
+In the Settings tab, '''Article Depth''' controls what each red link generates:
-; Click to generate (explore mode)
+; Full article
-: Click any red link to immediately trigger the agent to create that page. The new page loads in the preview automatically. This creates a "wiki rabbit hole" experience — the wiki expands as you browse through missing pages.
+: Generates a complete encyclopedia entry. After generation, the browser shows the new page.
-; Batch mode
+; Stub only
-: When red links are detected, a '''⚡ Generate N red links''' button appears in the browser toolbar. Click it to process all red links on the current page sequentially, with a 1-second pause between each.
+: Generates a minimal stub (section headers, 1–3 sentences per section, <nowiki>{{stub}}</nowiki> tag). After generation, the Context tab opens with the stub pre-loaded for review or expansion.
-In both modes, the agent uses the Context depth and Page type settings from the Settings tab to govern how content is generated.
+See [[Help:Ephemera Agent/Stub Workflow]] for the full stub → expand lifecycle.
 [[Category:Help]]
 [[Category:EphemeraAgent]]