@4fu/arbor-prompt 2026.1107.0 → 2026.1107.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@4fu/arbor-prompt",
-  "version": "2026.1107.0",
+  "version": "2026.1107.1",
   "type": "module",
   "description": "Typed prompt blocks, the one deterministic renderer, the replaceable Chinese text table and the system prompt sections.",
   "exports": {
@@ -49,6 +49,6 @@
   },
   "dependencies": {
     "@4fu/arbor-errors": "2026.1107.0",
-    "@4fu/arbor-interfaces": "2026.1107.0"
+    "@4fu/arbor-interfaces": "2026.1107.1"
   }
 }

package/system.d.ts

@@ -6,7 +6,7 @@
  * with the snapshot epoch, and rendering is deterministic: no timestamps or
  * counters reach it.
  */
-import type { DirectToolSpec, EnvItem, ModuleSpec, PromptSection, Settings } from "@4fu/arbor-interfaces";
+import type { DirectToolSpec, EnvItem, ModuleSpec, PromptSection, Settings, WindowRef } from "@4fu/arbor-interfaces";
 import { Renderer } from "./render.ts";
 /** What one epoch's system prompt is built from. */
 export interface SystemPromptInput {
@@ -55,17 +55,26 @@ export declare function sectionRevision(section: PromptSection): Promise<string>
  * One plugin's prompt section, rendered in its tag, with what it produced. The
  * revision it reports is what a later call compares against, so an unchanged
  * section is never rendered twice.
+ *
+ * `window` is the window this render is for: a section that serves several
+ * sessions answers for that one, and a section whose content is the same
+ * everywhere renders the same text for each
+ * (docs/prompting.md#plugin-sections-that-change).
  */
-export declare function renderPluginSection(section: PromptSection, renderer: Renderer): Promise<RenderedPluginSection>;
+export declare function renderPluginSection(section: PromptSection, renderer: Renderer, window?: WindowRef): Promise<RenderedPluginSection>;
 /**
- * Every plugin section, rendered once, in the order they registered. A section
- * whose content renders to nothing is still listed - with empty text - so a
- * later call can tell a section that stayed empty from one that appeared.
+ * Every plugin section, rendered once, in the order they registered, for the
+ * window they are rendered for. A section whose content renders to nothing is
+ * still listed - with empty text - so a later call can tell a section that
+ * stayed empty from one that appeared.
  */
-export declare function renderPluginSections(plugins: readonly PromptSection[], renderer: Renderer): Promise<readonly RenderedPluginSection[]>;
+export declare function renderPluginSections(plugins: readonly PromptSection[], renderer: Renderer, window?: WindowRef): Promise<readonly RenderedPluginSection[]>;
 /**
  * Build the frozen prefix. `plugins` are rendered first because their content
  * is produced per epoch, their sections render in a tag named after the plugin,
  * and one of them being outside is what puts the precedence rule into `<agent>`.
+ *
+ * `window` is the window the prefix is built for, when it is built for one: a
+ * section that renders per window makes this prefix that window's own.
  */
-export declare function renderSystemPrompt(input: SystemPromptInput, renderer: Renderer): Promise<RenderedSystemPrompt>;
+export declare function renderSystemPrompt(input: SystemPromptInput, renderer: Renderer, window?: WindowRef): Promise<RenderedSystemPrompt>;

package/system.js

@@ -93,9 +93,14 @@ function outsideBlock(content) {
  * One plugin's prompt section, rendered in its tag, with what it produced. The
  * revision it reports is what a later call compares against, so an unchanged
  * section is never rendered twice.
+ *
+ * `window` is the window this render is for: a section that serves several
+ * sessions answers for that one, and a section whose content is the same
+ * everywhere renders the same text for each
+ * (docs/prompting.md#plugin-sections-that-change).
  */
-export async function renderPluginSection(section, renderer) {
-    const content = await section.content();
+export async function renderPluginSection(section, renderer, window) {
+    const content = await section.content(window);
     return {
         tag: section.tag,
         text: renderer.render(section.outside === true ? [outsideBlock(content)] : content),
@@ -104,24 +109,28 @@ export async function renderPluginSection(section, renderer) {
     };
 }
 /**
- * Every plugin section, rendered once, in the order they registered. A section
- * whose content renders to nothing is still listed - with empty text - so a
- * later call can tell a section that stayed empty from one that appeared.
+ * Every plugin section, rendered once, in the order they registered, for the
+ * window they are rendered for. A section whose content renders to nothing is
+ * still listed - with empty text - so a later call can tell a section that
+ * stayed empty from one that appeared.
  */
-export async function renderPluginSections(plugins, renderer) {
+export async function renderPluginSections(plugins, renderer, window) {
     const rendered = [];
     for (const plugin of plugins)
-        rendered.push(await renderPluginSection(plugin, renderer));
+        rendered.push(await renderPluginSection(plugin, renderer, window));
     return rendered;
 }
 /**
  * Build the frozen prefix. `plugins` are rendered first because their content
  * is produced per epoch, their sections render in a tag named after the plugin,
  * and one of them being outside is what puts the precedence rule into `<agent>`.
+ *
+ * `window` is the window the prefix is built for, when it is built for one: a
+ * section that renders per window makes this prefix that window's own.
  */
-export async function renderSystemPrompt(input, renderer) {
+export async function renderSystemPrompt(input, renderer, window) {
     const table = renderer.table;
-    const sections = await renderPluginSections(input.plugins ?? [], renderer);
+    const sections = await renderPluginSections(input.plugins ?? [], renderer, window);
     const parts = sectionsOf(input, table, sections.some((section) => section.outside)).map((section) => [`<${section.tag}>`, ...section.lines, `</${section.tag}>`].join("\n"));
     for (const section of sections) {
         if (section.text === "")