@4fu/arbor-interfaces 2026.1107.0 → 2026.1107.1

package/agent.d.ts

@@ -354,7 +354,15 @@ export interface ToolCall {
 export interface ToolResult {
     callId: string;
     ok: boolean;
-    /** Stable fields, bounded, in the core's error shape when it failed. */
+    /**
+     * Stable fields, bounded, in the core's error shape when it failed.
+     *
+     * A refusal carries its own wording here as well as in `error`: the rule, the
+     * message and the next action, in the one form the journal records a refusal
+     * with. So an embedding that writes its own log passes the result through as
+     * it stands instead of reassembling the three parts, and what the record
+     * holds is what the caller was handed.
+     */
     content: string;
     /**
      * The tool that was called, as the prompt names it. A refusal carries it so

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@4fu/arbor-interfaces",
-  "version": "2026.1107.0",
+  "version": "2026.1107.1",
   "type": "module",
   "description": "Every replaceable interface in arbor, and the core's own shapes.",
   "exports": {

package/plugin.d.ts

@@ -16,6 +16,7 @@ import type { EffectExecutor } from "./effects.ts";
 import type { EnvDraft } from "./environment.ts";
 import type { JudgeCriteria } from "./judge.ts";
 import type { Hooks } from "./hooks.ts";
+import type { WindowRef } from "./refs.ts";
 import type { TaskSource } from "./task.ts";
 import type { ExternalTool, ExternalToolSource } from "./tools.ts";
 /** Connections to the outside world. */
@@ -30,8 +31,17 @@ export interface PromptSection {
     tag: string;
     /** The block kinds its inputs use, which the renderer maps to text. */
     blocks: readonly BlockKindSpec[];
-    /** Its content, as blocks. The plugin hands blocks, never finished text. */
-    content(): readonly Block[] | Promise<readonly Block[]>;
+    /**
+     * Its content, as blocks. The plugin hands blocks, never finished text.
+     *
+     * `window` is the window the section is rendered for, which the host names on
+     * every render: the epoch a window opens with, a delta of the changed lines
+     * while it runs. A section whose content is the same for every window ignores
+     * it; one that serves several sessions - one workspace per session, each
+     * naming the window it serves - answers for that window
+     * (docs/prompting.md#plugin-sections-that-change).
+     */
+    content(window?: WindowRef): readonly Block[] | Promise<readonly Block[]>;
     /**
      * The fixed strings its own blocks write, merged into the host's text table.
      * A plugin names no secret here, and writes no prompt text of its own: its
@@ -47,6 +57,16 @@ export interface PromptSection {
      * never changes once the host has rendered it.
      */
     revision?(): string | number | Promise<string | number>;
+    /**
+     * True when this section's content differs from window to window - a section
+     * that serves several sessions, one workspace per session, naming the window
+     * it serves. The host then renders it for each window instead of freezing it
+     * with the epoch, and that window's prefix is its own where this section is
+     * concerned; every other window still shares the epoch's prefix
+     * (docs/prompting.md#plugin-sections-that-change). Absent, like `false`: the
+     * section says the same thing to every window and is frozen with the epoch.
+     */
+    perWindow?: boolean;
     /**
      * True when the section is material from outside the framework - a third
      * party's prompt text, such as the sections a DeepSeek Harness plugin

package/workspace.d.ts

@@ -130,13 +130,30 @@ export interface Workspace {
     mount(ref: WorkspaceRef): Promise<WorkspaceMount>;
     /** The workspace's size and file count, for a quota a deployment sets. */
     quota(workspace: WorkspaceRef): Promise<WorkspaceQuota>;
-    /** Reclaim the workspace after the retention period. */
+    /**
+     * Reclaim the workspace after the retention period.
+     *
+     * An implementation whose workspace is a directory somebody else owns - a
+     * host's own project directory, which nothing here may remove - has no honest
+     * answer to give here: it says so with `reclaimable`, below, and the host
+     * never asks.
+     */
     reclaim(workspace: WorkspaceRef): Promise<void>;
+    /**
+     * Whether this implementation reclaims a workspace at all. `false` for one
+     * whose directory belongs to somebody else - the user's own project, which
+     * nothing here may remove - and the host then neither asks `refOf` for a ref
+     * to reclaim nor arms a retention deadline, so nothing is reclaimed and no
+     * failure is recorded either (docs/workspaces.md#lifecycle). Absent, like
+     * `true`: the implementation owns what it created and `reclaim` removes it.
+     */
+    reclaimable?(): boolean | Promise<boolean>;
     /**
      * The workspace a window's chain already has, or `undefined` when it has
      * none - the window never touched files, or the directory was reclaimed. The
      * host asks for it to reclaim a chain's directory once its last window has
-     * ended and the retention period has passed, which a restart has to survive
+     * ended and the retention period has passed - of an implementation that
+     * reclaims at all (`reclaimable`, above) - which a restart has to survive
      * (docs/workspaces.md#lifecycle).
      */
     refOf(window: WindowRef): Promise<WorkspaceRef | undefined>;
@@ -182,6 +199,11 @@ export interface Workspace {
      * method the model follows - how this implementation wants files changed -
      * rendered in its own tag, so each implementation owns its own prompt text and
      * a host that fell back to another implementation shows that one's instead.
+     *
+     * The host registers the section once and renders it per window, so a section
+     * that serves several sessions - one workspace per session, each naming the
+     * window it serves - answers for the window it is rendered for through
+     * `content(window)` (docs/prompting.md#plugin-sections-that-change).
      */
     promptSection?(table: TextTable): PromptSection;
     /**