@4fu/arbor-prompt 2026.1107.0 → 2026.1109.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@4fu/arbor-prompt",
-  "version": "2026.1107.0",
+  "version": "2026.1109.0",
   "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.1109.0"
   }
 }

package/render.js

@@ -10,7 +10,7 @@
  * - the output is deterministic, so the same blocks always give the same bytes.
  */
 import { BUILTIN_BLOCK_KINDS } from "./blocks.js";
-import { formatText, zhTextTable } from "./text.js";
+import { formatText, zhTextTable, PLACEHOLDER } from "./text.js";
 /** Joins refs, which are identifiers. */
 const REF_SEPARATOR = ", ";
 /** Joins a list of words inside one sentence. */
@@ -169,15 +169,20 @@ export class Renderer {
         const template = this.table[resolved];
         if (template === undefined)
             return undefined;
-        for (const [, name] of `${key} ${template}`.matchAll(/\{(\w+)\}/g)) {
+        for (const [, name] of `${key} ${template}`.matchAll(PLACEHOLDER)) {
             if (name === undefined)
                 continue;
             if (args[name] === undefined || args[name] === "")
                 return undefined;
             carried.add(name);
         }
+        // The line is complete when every placeholder its own template names has a
+        // value - never by scanning what was filled: a value that carries a `{` of
+        // its own, JSON in a message or a snippet in a note, is data the line must
+        // keep, not a placeholder it must drop for
+        // (docs/prompting.md#blocks-and-the-renderer).
         const filled = formatText(template, args);
-        if (filled.includes("{") || filled.trim() === "")
+        if (filled.trim() === "")
             return undefined;
         return filled;
     }

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,30 @@ 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). `label` is the opaque label
+ * the embedding attached to what that window serves, carried through
+ * (docs/windows.md#what-a-window-serves).
  */
-export declare function renderPluginSection(section: PromptSection, renderer: Renderer): Promise<RenderedPluginSection>;
+export declare function renderPluginSection(section: PromptSection, renderer: Renderer, window?: WindowRef, label?: string): 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, label?: string): 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. `label`
+ * is the opaque label the embedding attached to what that window serves, which
+ * a per-window section reads (docs/windows.md#what-a-window-serves).
  */
-export declare function renderSystemPrompt(input: SystemPromptInput, renderer: Renderer): Promise<RenderedSystemPrompt>;
+export declare function renderSystemPrompt(input: SystemPromptInput, renderer: Renderer, window?: WindowRef, label?: string): Promise<RenderedSystemPrompt>;

package/system.js

@@ -93,9 +93,16 @@ 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). `label` is the opaque label
+ * the embedding attached to what that window serves, carried through
+ * (docs/windows.md#what-a-window-serves).
  */
-export async function renderPluginSection(section, renderer) {
-    const content = await section.content();
+export async function renderPluginSection(section, renderer, window, label) {
+    const content = await section.content(window, label);
     return {
         tag: section.tag,
         text: renderer.render(section.outside === true ? [outsideBlock(content)] : content),
@@ -104,24 +111,30 @@ 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, label) {
     const rendered = [];
     for (const plugin of plugins)
-        rendered.push(await renderPluginSection(plugin, renderer));
+        rendered.push(await renderPluginSection(plugin, renderer, window, label));
     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. `label`
+ * is the opaque label the embedding attached to what that window serves, which
+ * a per-window section reads (docs/windows.md#what-a-window-serves).
  */
-export async function renderSystemPrompt(input, renderer) {
+export async function renderSystemPrompt(input, renderer, window, label) {
     const table = renderer.table;
-    const sections = await renderPluginSections(input.plugins ?? [], renderer);
+    const sections = await renderPluginSections(input.plugins ?? [], renderer, window, label);
     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 === "")

package/text.d.ts

@@ -11,6 +11,13 @@ import type { TextTable } from "@4fu/arbor-interfaces";
 export type TextArgs = Record<string, string | number>;
 /** The framework's own table: Chinese, one entry per fixed string. */
 export declare const zhTextTable: TextTable;
+/**
+ * One placeholder in a table entry: `{name}`. It is the whole vocabulary of
+ * what a renderer fills, so anything else inside braces - `{ everyMs }` written
+ * with spaces, a `{` a filled value carries - is literal text and stays as it
+ * was written.
+ */
+export declare const PLACEHOLDER: RegExp;
 /** Fill one table entry. Unknown placeholders are left as they are. */
 export declare function formatText(template: string, args?: TextArgs): string;
 /**

package/text.js

@@ -94,7 +94,7 @@ export const zhTextTable = {
     "continuation.open_work": "上个窗口链未完成的工作：{openWork}；按需继续或收尾，状态写进笔记和交接内容。",
     // ---- results and refusals the tools report -----------------------------
     "secret.hidden": "[hidden:{name}]",
-    "result.sent": "已记录 {ref}，效果已入队。",
+    "result.sent": "已记录 {ref}，效果已入队；执行结果以效果结果事件为准。",
     "result.effect.ok": "效果 {ref} 已执行。",
     "result.effect.failed": "效果 {ref} 没有执行（{reason}）。",
     "result.window_message": "消息 {ref} 已发送给 {window}。",
@@ -168,6 +168,7 @@ export const zhTextTable = {
     "refused.send.target": "发送目标不能为空。",
     "refused.send.content": "发送内容不能为空。",
     "refused.send.secret": "发送内容包含环境变量 {name} 的原始值，本次没有发送。",
+    "refused.send.unowned": "没有效果执行器负责目标 {target}，本次没有发送。",
     "refused.bash.notfound": "没有作业 {job}。",
     "refused.note.write.journal": "笔记 {ref} 没有写入：记录拒绝了这次事件（{detail}）。",
     "refused.note.write.title": "笔记需要一个标题。",
@@ -234,6 +235,7 @@ export const zhTextTable = {
     "next.send.target": "目标写成一个引用或一个外部 id。",
     "next.send.content": "补上要发送的内容。",
     "next.send.secret": "请删去其中涉及该值的内容，或只写变量名 {name} 指代，然后重发。",
+    "next.send.unowned": "用 channels.list 查看已接入的频道，把内容发到有频道负责的目标。",
     "next.bash.notfound": "用 bash 重新执行该命令；本窗口不会收到后台作业的完成通知，需要结果时用 bash_output 查询。",
     "next.note.write.journal": "修正记录拒绝的原因，然后重新写入。",
     "next.note.write.title": "补上一个简短标题。",
@@ -377,11 +379,18 @@ export const zhTextTable = {
     "function.services.status": "查看一个服务的状态：版本、端口、重启次数和最近错误。",
     "function.services.logs": "读取一个服务的日志，可按行数取尾部。",
 };
+/**
+ * One placeholder in a table entry: `{name}`. It is the whole vocabulary of
+ * what a renderer fills, so anything else inside braces - `{ everyMs }` written
+ * with spaces, a `{` a filled value carries - is literal text and stays as it
+ * was written.
+ */
+export const PLACEHOLDER = /\{(\w+)\}/g;
 /** Fill one table entry. Unknown placeholders are left as they are. */
 export function formatText(template, args) {
     if (args === undefined)
         return template;
-    return template.replace(/\{(\w+)\}/g, (match, key) => {
+    return template.replace(PLACEHOLDER, (match, key) => {
         const value = args[key];
         return value === undefined ? match : String(value);
     });