@ouispec/agent-worker 0.1.1 → 0.2.0

package/dist/tools/builtin-tools.js.map

@@ -1 +1 @@
-{"version":3,"file":"builtin-tools.js","sourceRoot":"","sources":["../../src/tools/builtin-tools.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"builtin-tools.js","sourceRoot":"","sources":["../../src/tools/builtin-tools.ts"],"names":[],"mappings":"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"}

package/dist/tools/types.d.ts

@@ -27,6 +27,14 @@ export interface RegisteredTool {
     destructive?: boolean;
     description: string;
     inputSchema: Record<string, unknown>;
+    /**
+     * The schema a call's input is checked against, when it is not known until
+     * the tool is used: a UI action's definition is fetched from the page then
+     * (ADR-0245 §2.1). Called once per call, before validation; `inputSchema`
+     * only stands in for it. A rejection is told to the model as the reason the
+     * call did not run.
+     */
+    resolveInputSchema?: (ctx: ToolExecutionContext) => Promise<Record<string, unknown>>;
     execute: (input: Record<string, unknown>, ctx: ToolExecutionContext) => Promise<ToolExecutionResult>;
     /** Its name as a person reads it, for the approval card. Default: `name`. */
     title?: string;
@@ -73,6 +81,15 @@ export interface ToolExecutionResult {
     success: boolean;
     data?: unknown;
     error?: string;
+    /**
+     * A picture the model is given beside the result's text, as an image part
+     * of the tool result. It is given once and stored nowhere: `data` says what
+     * the picture is.
+     */
+    image?: {
+        mediaType: string;
+        base64: string;
+    };
 }
 export interface ToolRegistry {
     tools: RegisteredTool[];

package/dist/tools/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/tools/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAClF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAEnD;;;GAGG;AAEH;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG,YAAY,CAAC;AAEtC,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,IAAI,CAAC,EAAE,IAAI,GAAG,SAAS,CAAC;IACxB;;;OAGG;IACH,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,yEAAyE;IACzE,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,oBAAoB,KAAK,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACrG,6EAA6E;IAC7E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2EAA2E;IAC3E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,UAAU,CAAC,EAAE,eAAe,CAAC;IAC7B,0FAA0F;IAC1F,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,2EAA2E;IAC3E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6EAA6E;IAC7E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,qBAAqB,CAAC;IACjC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,oBAAoB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;CAChH;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,YAAY,CAiBxE"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/tools/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAClF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAEnD;;;GAGG;AAEH;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG,YAAY,CAAC;AAEtC,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,IAAI,CAAC,EAAE,IAAI,GAAG,SAAS,CAAC;IACxB;;;OAGG;IACH,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,yEAAyE;IACzE,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC;;;;;;OAMG;IACH,kBAAkB,CAAC,EAAE,CAAC,GAAG,EAAE,oBAAoB,KAAK,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACrF,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,oBAAoB,KAAK,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACrG,6EAA6E;IAC7E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2EAA2E;IAC3E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,UAAU,CAAC,EAAE,eAAe,CAAC;IAC7B,0FAA0F;IAC1F,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,2EAA2E;IAC3E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6EAA6E;IAC7E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,qBAAqB,CAAC;IACjC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,KAAK,CAAC,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAC/C;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,oBAAoB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;CAChH;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,YAAY,CAiBxE"}

package/dist/tools/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/tools/types.ts"],"names":[],"mappings":"AAuFA;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAuB;IACxD,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAErD,OAAO;QACL,KAAK;QACL,KAAK,CAAC,OAAO,CAAC,IAAY,EAAE,KAA8B,EAAE,GAAyB;YACnF,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAC/B,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,iBAAiB,IAAI,EAAE,EAAE,CAAC;YAC5D,CAAC;YACD,IAAI,CAAC;gBACH,OAAO,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;YACxC,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;YACrF,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/tools/types.ts"],"names":[],"mappings":"AAqGA;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAuB;IACxD,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAErD,OAAO;QACL,KAAK;QACL,KAAK,CAAC,OAAO,CAAC,IAAY,EAAE,KAA8B,EAAE,GAAyB;YACnF,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAC/B,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,iBAAiB,IAAI,EAAE,EAAE,CAAC;YAC5D,CAAC;YACD,IAAI,CAAC;gBACH,OAAO,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;YACxC,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;YACrF,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/turn-ledger.d.ts

@@ -0,0 +1,30 @@
+/**
+ * The turn's own record of what its calls did (ADR-0244 §2.5).
+ *
+ * A model writes its closing message from memory of a long turn, and a
+ * failure a dozen steps back is easy to pass over: on 2026-10-02 the
+ * assistant asked for a 2-second duration, got 5, and told the person 5 was
+ * better; it reported five layers centred when two had not moved. The worker
+ * knows what each call returned, so before every step after one did not
+ * succeed it says so again, in one place, and the reply is held to it.
+ *
+ * Nothing is added while every call has succeeded: the record costs nothing
+ * on a turn that went well.
+ */
+/** One call of the turn. */
+export interface LedgerEntry {
+    tool: string;
+    ok: boolean;
+    /** Why it did not succeed, or did not run, in the words the model was given. */
+    error?: string;
+}
+export interface TurnLedger {
+    record(entry: LedgerEntry): void;
+    entries(): readonly LedgerEntry[];
+    /** The note for the next step, or null while every call has succeeded. */
+    note(): string | null;
+}
+export declare function createTurnLedger(): TurnLedger;
+/** What the model is told about the turn so far, when any call did not succeed. */
+export declare function ledgerNote(calls: readonly LedgerEntry[]): string | null;
+//# sourceMappingURL=turn-ledger.d.ts.map

package/dist/turn-ledger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn-ledger.d.ts","sourceRoot":"","sources":["../src/turn-ledger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,4BAA4B;AAC5B,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,OAAO,CAAC;IACZ,gFAAgF;IAChF,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAAC;IACjC,OAAO,IAAI,SAAS,WAAW,EAAE,CAAC;IAClC,0EAA0E;IAC1E,IAAI,IAAI,MAAM,GAAG,IAAI,CAAC;CACvB;AASD,wBAAgB,gBAAgB,IAAI,UAAU,CAO7C;AAED,mFAAmF;AACnF,wBAAgB,UAAU,CAAC,KAAK,EAAE,SAAS,WAAW,EAAE,GAAG,MAAM,GAAG,IAAI,CAiBvE"}

package/dist/turn-ledger.js

@@ -0,0 +1,45 @@
+/**
+ * The turn's own record of what its calls did (ADR-0244 §2.5).
+ *
+ * A model writes its closing message from memory of a long turn, and a
+ * failure a dozen steps back is easy to pass over: on 2026-10-02 the
+ * assistant asked for a 2-second duration, got 5, and told the person 5 was
+ * better; it reported five layers centred when two had not moved. The worker
+ * knows what each call returned, so before every step after one did not
+ * succeed it says so again, in one place, and the reply is held to it.
+ *
+ * Nothing is added while every call has succeeded: the record costs nothing
+ * on a turn that went well.
+ */
+/** How much of each failure's reason the note repeats. */
+const MAX_REASON_CHARS = 240;
+/** How many failures the note lists one by one; the rest are counted. */
+const MAX_LISTED = 12;
+const clip = (text) => (text.length > MAX_REASON_CHARS ? `${text.slice(0, MAX_REASON_CHARS)}…` : text);
+export function createTurnLedger() {
+    const calls = [];
+    return {
+        record: (entry) => void calls.push(entry),
+        entries: () => calls,
+        note: () => ledgerNote(calls),
+    };
+}
+/** What the model is told about the turn so far, when any call did not succeed. */
+export function ledgerNote(calls) {
+    const failed = calls.filter((c) => !c.ok);
+    if (failed.length === 0)
+        return null;
+    const listed = failed
+        .slice(0, MAX_LISTED)
+        .map((c) => `- ${c.tool}: ${clip(c.error ?? 'did not succeed')}`)
+        .join('\n');
+    const more = failed.length > MAX_LISTED ? `\n- … and ${failed.length - MAX_LISTED} more` : '';
+    return (`<turn_record>\n` +
+        `This turn has made ${calls.length} call${calls.length === 1 ? '' : 's'}; ${failed.length} did not succeed:\n` +
+        `${listed}${more}\n` +
+        `What you tell the person must match this record. For each of these, either it has since been done by a later call ` +
+        `that succeeded, or your reply says it was not done and why. Never describe a call that did not succeed as done, ` +
+        `and never present what you got in place of what was asked as if it were what was asked.\n` +
+        `</turn_record>`);
+}
+//# sourceMappingURL=turn-ledger.js.map

package/dist/turn-ledger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn-ledger.js","sourceRoot":"","sources":["../src/turn-ledger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAiBH,0DAA0D;AAC1D,MAAM,gBAAgB,GAAG,GAAG,CAAC;AAC7B,yEAAyE;AACzE,MAAM,UAAU,GAAG,EAAE,CAAC;AAEtB,MAAM,IAAI,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,GAAG,gBAAgB,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AAE/G,MAAM,UAAU,gBAAgB;IAC9B,MAAM,KAAK,GAAkB,EAAE,CAAC;IAChC,OAAO;QACL,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC;QACzC,OAAO,EAAE,GAAG,EAAE,CAAC,KAAK;QACpB,IAAI,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC;KAC9B,CAAC;AACJ,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,UAAU,CAAC,KAA6B;IACtD,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAC1C,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACrC,MAAM,MAAM,GAAG,MAAM;SAClB,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC;SACpB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,iBAAiB,CAAC,EAAE,CAAC;SAChE,IAAI,CAAC,IAAI,CAAC,CAAC;IACd,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC,aAAa,MAAM,CAAC,MAAM,GAAG,UAAU,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;IAC9F,OAAO,CACL,iBAAiB;QACjB,sBAAsB,KAAK,CAAC,MAAM,QAAQ,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,MAAM,CAAC,MAAM,qBAAqB;QAC9G,GAAG,MAAM,GAAG,IAAI,IAAI;QACpB,oHAAoH;QACpH,kHAAkH;QAClH,2FAA2F;QAC3F,gBAAgB,CACjB,CAAC;AACJ,CAAC"}

package/dist/types.d.ts

@@ -29,7 +29,12 @@ export interface AgentWorkerConfig {
     promptCacheBreakpoint?: ProviderOptions;
     maxToolRounds?: number;
     maxTokens?: number;
-    temperature?: number;
+    /**
+     * The sampling temperature. Default 0.3. `null` sends none: for a model that
+     * does not take one (Claude Sonnet 5.5 on Bedrock refuses a request that
+     * names it), the model's own sampling is used.
+     */
+    temperature?: number | null;
     toolTimeoutMs?: number;
     turnDeadlineMs?: number;
     retries?: number;
@@ -56,8 +61,10 @@ export interface AgentWorkerConfig {
         channel: UIActionChannel;
         /** How long a UI tool waits for the client's answer. Default 20 s. */
         resultTimeoutMs?: number;
-        /** Largest page-state payload given to the model, in characters. Default 6000. */
+        /** Largest page-state payload given to the model, in characters. Default 12000 (`DEFAULT_PAGE_STATE_CHARS`). */
         maxObservationChars?: number;
+        /** Largest index of the page's actions given to the model, in characters. Default 60000 (`DEFAULT_INDEX_CHARS`). */
+        maxIndexChars?: number;
     };
 }
 export interface SystemPromptContext {

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/ui/answer-image.d.ts

@@ -0,0 +1,32 @@
+/**
+ * A picture in an action's answer (ADR-0244 §2.2, ADR-0245 §2.4).
+ *
+ * A room can answer a read with what it draws: `data.image`, an encoded
+ * picture. As JSON text its base64 would cost the model hundreds of thousands
+ * of characters and show it nothing, so the worker lifts it out: the model is
+ * given the picture itself as an image part of the tool result, and the text
+ * keeps only what the picture is (its type and size). The base64 is given to
+ * the model once and kept nowhere: the socket event, the turn's record and the
+ * stored tool result carry the text.
+ */
+/** The picture types a model is given. */
+export declare const ANSWER_IMAGE_MEDIA_TYPES: readonly ["image/png", "image/jpeg", "image/webp"];
+/** The longest base64 a picture may be, in characters (256 KB): past it the picture is left out, and said so. */
+export declare const MAX_ANSWER_IMAGE_BASE64_CHARS: number;
+/** A picture for the model: its type and its bytes in base64. */
+export interface AnswerImage {
+    mediaType: (typeof ANSWER_IMAGE_MEDIA_TYPES)[number];
+    base64: string;
+}
+/**
+ * `data` with its picture lifted out: `data.image` keeps its type and size,
+ * and the picture is returned beside it. Only `data.image` in the shape
+ * `{ mediaType, base64, width, height }` is a picture; anything else is left
+ * as it is. A picture of a type the model is not given, or past the size, is
+ * left out of both, and `data.image.leftOut` says why.
+ */
+export declare function liftAnswerImage(data: unknown): {
+    data: unknown;
+    image?: AnswerImage;
+};
+//# sourceMappingURL=answer-image.d.ts.map

package/dist/ui/answer-image.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"answer-image.d.ts","sourceRoot":"","sources":["../../src/ui/answer-image.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,0CAA0C;AAC1C,eAAO,MAAM,wBAAwB,oDAAqD,CAAC;AAC3F,iHAAiH;AACjH,eAAO,MAAM,6BAA6B,QAAa,CAAC;AAExD,iEAAiE;AACjE,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,CAAC,OAAO,wBAAwB,CAAC,CAAC,MAAM,CAAC,CAAC;IACrD,MAAM,EAAE,MAAM,CAAC;CAChB;AAKD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,OAAO,GAAG;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,WAAW,CAAA;CAAE,CAuBrF"}

package/dist/ui/answer-image.js

@@ -0,0 +1,50 @@
+/**
+ * A picture in an action's answer (ADR-0244 §2.2, ADR-0245 §2.4).
+ *
+ * A room can answer a read with what it draws: `data.image`, an encoded
+ * picture. As JSON text its base64 would cost the model hundreds of thousands
+ * of characters and show it nothing, so the worker lifts it out: the model is
+ * given the picture itself as an image part of the tool result, and the text
+ * keeps only what the picture is (its type and size). The base64 is given to
+ * the model once and kept nowhere: the socket event, the turn's record and the
+ * stored tool result carry the text.
+ */
+/** The picture types a model is given. */
+export const ANSWER_IMAGE_MEDIA_TYPES = ['image/png', 'image/jpeg', 'image/webp'];
+/** The longest base64 a picture may be, in characters (256 KB): past it the picture is left out, and said so. */
+export const MAX_ANSWER_IMAGE_BASE64_CHARS = 256 * 1024;
+const isRecord = (value) => !!value && typeof value === 'object' && !Array.isArray(value);
+const BASE64 = /^[A-Za-z0-9+/]+={0,2}$/;
+/**
+ * `data` with its picture lifted out: `data.image` keeps its type and size,
+ * and the picture is returned beside it. Only `data.image` in the shape
+ * `{ mediaType, base64, width, height }` is a picture; anything else is left
+ * as it is. A picture of a type the model is not given, or past the size, is
+ * left out of both, and `data.image.leftOut` says why.
+ */
+export function liftAnswerImage(data) {
+    if (!isRecord(data) || !isRecord(data.image))
+        return { data };
+    const { mediaType, base64, ...rest } = data.image;
+    if (typeof mediaType !== 'string' || typeof base64 !== 'string')
+        return { data };
+    const described = (extra = {}) => ({ ...data, image: { ...rest, mediaType, ...extra } });
+    if (!ANSWER_IMAGE_MEDIA_TYPES.includes(mediaType)) {
+        return { data: described({ leftOut: `a picture of type ${mediaType} cannot be shown to you; ${ANSWER_IMAGE_MEDIA_TYPES.join(', ')} can` }) };
+    }
+    if (base64.length > MAX_ANSWER_IMAGE_BASE64_CHARS) {
+        return {
+            data: described({
+                leftOut: `the picture is ${base64.length} characters of base64; one of at most ${MAX_ANSWER_IMAGE_BASE64_CHARS} can be shown to you. Ask for it smaller if the action takes a size.`,
+            }),
+        };
+    }
+    if (base64.length === 0 || !BASE64.test(base64)) {
+        return { data: described({ leftOut: 'the picture was not valid base64' }) };
+    }
+    return {
+        data: described({ shown: 'The picture is attached to this result: look at it.' }),
+        image: { mediaType: mediaType, base64 },
+    };
+}
+//# sourceMappingURL=answer-image.js.map

package/dist/ui/answer-image.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"answer-image.js","sourceRoot":"","sources":["../../src/ui/answer-image.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,0CAA0C;AAC1C,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,WAAW,EAAE,YAAY,EAAE,YAAY,CAAU,CAAC;AAC3F,iHAAiH;AACjH,MAAM,CAAC,MAAM,6BAA6B,GAAG,GAAG,GAAG,IAAI,CAAC;AAQxD,MAAM,QAAQ,GAAG,CAAC,KAAc,EAAoC,EAAE,CAAC,CAAC,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AACrI,MAAM,MAAM,GAAG,wBAAwB,CAAC;AAExC;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAAC,IAAa;IAC3C,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC9D,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC;IAClD,IAAI,OAAO,SAAS,KAAK,QAAQ,IAAI,OAAO,MAAM,KAAK,QAAQ;QAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAEjF,MAAM,SAAS,GAAG,CAAC,QAAiC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,EAAE,GAAG,IAAI,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,CAAC,CAAC;IAClH,IAAI,CAAE,wBAA8C,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QACzE,OAAO,EAAE,IAAI,EAAE,SAAS,CAAC,EAAE,OAAO,EAAE,qBAAqB,SAAS,4BAA4B,wBAAwB,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC;IAC/I,CAAC;IACD,IAAI,MAAM,CAAC,MAAM,GAAG,6BAA6B,EAAE,CAAC;QAClD,OAAO;YACL,IAAI,EAAE,SAAS,CAAC;gBACd,OAAO,EAAE,kBAAkB,MAAM,CAAC,MAAM,yCAAyC,6BAA6B,sEAAsE;aACrL,CAAC;SACH,CAAC;IACJ,CAAC;IACD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QAChD,OAAO,EAAE,IAAI,EAAE,SAAS,CAAC,EAAE,OAAO,EAAE,kCAAkC,EAAE,CAAC,EAAE,CAAC;IAC9E,CAAC;IACD,OAAO;QACL,IAAI,EAAE,SAAS,CAAC,EAAE,KAAK,EAAE,qDAAqD,EAAE,CAAC;QACjF,KAAK,EAAE,EAAE,SAAS,EAAE,SAAqC,EAAE,MAAM,EAAE;KACpE,CAAC;AACJ,CAAC"}

package/dist/ui/observations.d.ts

@@ -22,20 +22,44 @@ export declare function surfaceProblems(observations: OUIObservationSnapshot): R
  * they must reach it whatever else the page reports.
  */
 export declare function jobStatuses(observations: OUIObservationSnapshot): Record<string, Record<string, unknown>> | null;
-/** Rows past this in any list are summed up as "… and N more" at the first step of fitting an over-budget page state. */
+/**
+ * The largest page state the model is given when the host sets none
+ * (`ui.maxObservationChars`): the user's message's, and each UI action's
+ * answer's. About 3,000 tokens: room for a document of a hundred rows as index
+ * rows with the few being worked on whole (ADR-0244 §2.1). It was 6,000, which
+ * a board of six artboards filled.
+ */
+export declare const DEFAULT_PAGE_STATE_CHARS = 12000;
+/** Rows past this in any list are given as index rows at the first step of fitting an over-budget page state. */
 export declare const MAX_LIST_ROWS = 20;
 /**
  * A list this short is never shortened: it is a field's choices (the engines a
  * voice can speak with, a document's types), not a collection to browse.
  */
 export declare const WHOLE_LIST_ROWS = 5;
+/** Each surface's observation schemas, by surface id then observation id: where the row lists are declared. */
+export type ObservationSchemas = Readonly<Record<string, Readonly<Record<string, unknown>>>>;
+/** The observation schemas of a turn's surfaces, for fitting their page state. */
+export declare function observationSchemas(surfaces: readonly {
+    id: string;
+    observations?: readonly {
+        id: string;
+        schema?: unknown;
+    }[];
+}[]): ObservationSchemas;
+/** What fitting reads beside the observations: where the row lists are declared, and the rows an action just changed. */
+export interface FitOptions {
+    schemas?: ObservationSchemas;
+    /** Refs of the rows the answered action changed: kept whole, like the selection. */
+    changed?: readonly string[];
+}
 /**
  * The observations as the model receives them: whole when they fit. Over
  * budget, every surface's problems and job statuses are kept whole; the rest is
- * fitted (see fitted): long lists shortened first, the page it acted on first
- * and kept whole, and only if that still does not fit is the rest cut, saying so.
+ * fitted (see fitted): long lists cut to index rows first, the page it acted on
+ * first and kept whole, and only if that still does not fit is the rest cut, saying so.
  */
-export declare function boundObservations(observations: OUIObservationSnapshot, maxChars: number, actingSurfaceId?: string): unknown;
+export declare function boundObservations(observations: OUIObservationSnapshot, maxChars: number, actingSurfaceId?: string, options?: FitOptions): unknown;
 /** The same, as the text of a `<page_state>` block. */
-export declare function observationsText(observations: OUIObservationSnapshot, maxChars: number): string;
+export declare function observationsText(observations: OUIObservationSnapshot, maxChars: number, options?: FitOptions): string;
 //# sourceMappingURL=observations.d.ts.map

package/dist/ui/observations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"observations.d.ts","sourceRoot":"","sources":["../../src/ui/observations.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAE5D,sEAAsE;AACtE,eAAO,MAAM,uBAAuB,aAAa,CAAC;AAElD,uFAAuF;AACvF,wBAAgB,eAAe,CAAC,YAAY,EAAE,sBAAsB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CASpG;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,YAAY,EAAE,sBAAsB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,IAAI,CAShH;AAgBD,yHAAyH;AACzH,eAAO,MAAM,aAAa,KAAK,CAAC;AAEhC;;;GAGG;AACH,eAAO,MAAM,eAAe,IAAI,CAAC;AAgKjC;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,YAAY,EAAE,sBAAsB,EACpC,QAAQ,EAAE,MAAM,EAChB,eAAe,CAAC,EAAE,MAAM,GACvB,OAAO,CAcT;AAED,uDAAuD;AACvD,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,sBAAsB,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAc/F"}
+{"version":3,"file":"observations.d.ts","sourceRoot":"","sources":["../../src/ui/observations.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAE5D,sEAAsE;AACtE,eAAO,MAAM,uBAAuB,aAAa,CAAC;AAElD,uFAAuF;AACvF,wBAAgB,eAAe,CAAC,YAAY,EAAE,sBAAsB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CASpG;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,YAAY,EAAE,sBAAsB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,IAAI,CAShH;AAgBD;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB,QAAS,CAAC;AAE/C,iHAAiH;AACjH,eAAO,MAAM,aAAa,KAAK,CAAC;AAEhC;;;GAGG;AACH,eAAO,MAAM,eAAe,IAAI,CAAC;AA6DjC,+GAA+G;AAC/G,MAAM,MAAM,kBAAkB,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;AAE7F,kFAAkF;AAClF,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,SAAS;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,SAAS;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,EAAE,CAAA;CAAE,EAAE,GAC9F,kBAAkB,CAIpB;AAsID,yHAAyH;AACzH,MAAM,WAAW,UAAU;IACzB,OAAO,CAAC,EAAE,kBAAkB,CAAC;IAC7B,oFAAoF;IACpF,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7B;AAuFD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,YAAY,EAAE,sBAAsB,EACpC,QAAQ,EAAE,MAAM,EAChB,eAAe,CAAC,EAAE,MAAM,EACxB,OAAO,GAAE,UAAe,GACvB,OAAO,CAcT;AAED,uDAAuD;AACvD,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,sBAAsB,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,UAAe,GAAG,MAAM,CAczH"}

package/dist/ui/observations.js

@@ -48,15 +48,31 @@ function withoutKeptWhole(observations) {
         Object.fromEntries(Object.entries(values ?? {}).filter(([id]) => id !== PROBLEMS_OBSERVATION_ID && !isJobStatus(id))),
     ]));
 }
-/** Rows past this in any list are summed up as "… and N more" at the first step of fitting an over-budget page state. */
+/**
+ * The largest page state the model is given when the host sets none
+ * (`ui.maxObservationChars`): the user's message's, and each UI action's
+ * answer's. About 3,000 tokens: room for a document of a hundred rows as index
+ * rows with the few being worked on whole (ADR-0244 §2.1). It was 6,000, which
+ * a board of six artboards filled.
+ */
+export const DEFAULT_PAGE_STATE_CHARS = 12_000;
+/** Rows past this in any list are given as index rows at the first step of fitting an over-budget page state. */
 export const MAX_LIST_ROWS = 20;
 /**
  * A list this short is never shortened: it is a field's choices (the engines a
  * voice can speak with, a document's types), not a collection to browse.
  */
 export const WHOLE_LIST_ROWS = 5;
-/** How far long lists are shortened, step by step; 0 gives only how many rows there are. */
-const LIST_STEPS = [MAX_LIST_ROWS, 10, WHOLE_LIST_ROWS, 0];
+const LIST_STEPS = [
+    { whole: MAX_LIST_ROWS, index: Infinity },
+    { whole: 10, index: Infinity },
+    { whole: WHOLE_LIST_ROWS, index: Infinity },
+    { whole: 0, index: Infinity },
+    { whole: 0, index: 100 },
+    { whole: 0, index: 40 },
+    { whole: 0, index: 12 },
+    { whole: 0, index: 0 },
+];
 /**
  * What a page state reports that is never shortened: its fields, what is
  * unavailable or busy, and a row's own schema (its options or range).
@@ -80,27 +96,64 @@ function surfaceRank(surfaceId, acting) {
         return 4;
     return 3;
 }
+/** The observation schemas of a turn's surfaces, for fitting their page state. */
+export function observationSchemas(surfaces) {
+    return Object.fromEntries(surfaces.map((s) => [s.id, Object.fromEntries((s.observations ?? []).map((o) => [o.id, o.schema]))]));
+}
+/** A page list's row (oui-bindings `PageStateRow`): addressed by its key, called by its title, chosen when its value is true. */
+const PAGE_ROW = {
+    index: (row) => ({ key: row.key, title: row.title }),
+    chosen: (row) => row !== null && typeof row === 'object' && row.value === true,
+    rest: 'name a row by its title',
+};
+const isPageRow = (row) => row !== null &&
+    typeof row === 'object' &&
+    typeof row.key === 'string' &&
+    typeof row.title === 'string';
+/** A declared list's rows: addressed and called by the properties it names, chosen when selected or just changed. */
+function declaredShape(declaration, chosenRefs) {
+    const kept = [declaration.ref, declaration.title, ...(declaration.index ?? [])];
+    return {
+        index: (row) => Object.fromEntries(kept.filter((key) => row[key] !== undefined).map((key) => [key, row[key]])),
+        chosen: (row) => row !== null && typeof row === 'object' && chosenRefs.has(String(row[declaration.ref])),
+        rest: 'read them with this surface’s query tool, or one with its inspect tool',
+    };
+}
 /** A row the person has chosen (a selected card, the variant in use): kept however short its list gets. */
-const isChosen = (row) => row !== null && typeof row === 'object' && row.value === true;
-/** A list shortened to `limit` rows plus the chosen ones and how many more; only a count at 0. */
-function shortenRows(rows, limit) {
-    if (rows.length <= Math.max(limit, WHOLE_LIST_ROWS))
+const isChosenValue = PAGE_ROW.chosen;
+/**
+ * A list fitted to a step: the first `whole` rows and the chosen ones whole,
+ * up to `index` of the rest as index rows, and how many are left out with how
+ * to read them. A list whose rows cannot be indexed keeps only how many more
+ * there are.
+ */
+function shortenRows(rows, step, shape) {
+    if (rows.length <= Math.max(step.whole, WHOLE_LIST_ROWS))
         return rows;
-    if (limit === 0) {
-        const chosen = rows.filter(isChosen);
-        const count = `${rows.length - chosen.length}${chosen.length ? ' more' : ''} rows`;
-        return [...chosen, `${count}, not listed to fit the page state; name a row by its title`];
+    const chosen = shape?.chosen ?? isChosenValue;
+    const whole = [];
+    const rest = [];
+    rows.forEach((row, i) => (i < step.whole || chosen(row) ? whole : rest).push(row));
+    if (!shape) {
+        if (step.whole === 0) {
+            const count = `${rest.length}${whole.length ? ' more' : ''} rows`;
+            return [...whole, `${count}, not listed to fit the page state; name a row by its title`];
+        }
+        return [...whole, `… and ${rest.length} more`];
     }
-    const kept = rows.slice(0, limit);
-    const chosen = rows.slice(limit).filter(isChosen);
-    return [...kept, ...chosen, `… and ${rows.length - kept.length - chosen.length} more`];
+    const indexed = rest.slice(0, step.index).map((row) => shape.index(row));
+    const left = rest.length - indexed.length;
+    if (left === 0)
+        return [...whole, ...indexed];
+    const count = whole.length + indexed.length > 0 ? `… and ${left} more rows` : `${left} rows`;
+    return [...whole, ...indexed, `${count}, not listed to fit the page state; ${shape.rest}`];
 }
 /**
  * What the page shows (`shown`): facts that describe one row of a list (one per
  * card) are shortened like the list; the page's own facts, such as those of the
  * item open in a detail panel, are kept whole.
  */
-function shortenShown(shown, limit) {
+function shortenShown(shown, step) {
     const perList = new Map();
     const own = [];
     for (const entry of shown) {
@@ -112,24 +165,37 @@ function shortenShown(shown, limit) {
             perList.set(id, [...(perList.get(id) ?? []), entry]);
         }
     }
-    return [...own, ...[...perList.values()].flatMap((rows) => shortenRows(rows, limit))];
+    return [...own, ...[...perList.values()].flatMap((rows) => shortenRows(rows, { whole: step.whole, index: 0 }, null))];
+}
+/** How a list's rows are indexed: as its schema declares, as a page list's rows are, or not at all. */
+function shapeOf(rows, schema, selected, ctx) {
+    const declaration = schema?.['x-rows'];
+    if (declaration)
+        return declaredShape(declaration, new Set([...selected, ...ctx.changed]));
+    return rows.length > 0 && rows.every(isPageRow) ? PAGE_ROW : null;
 }
 /**
- * The value with every long list shortened to `limit` (see shortenRows); fields,
+ * The value with every long list fitted to the step (see shortenRows); fields,
  * what is unavailable or busy, and the page's own facts are left whole.
  */
-function compactValue(value, limit) {
+function compactValue(value, schema, ctx, selected = []) {
     if (Array.isArray(value)) {
-        const rows = value.map((v) => compactValue(v, limit));
-        return shortenRows(rows, limit);
+        const shape = shapeOf(value, schema, selected, ctx);
+        // A row kept whole has its own lists fitted; a row cut to its index does not need them.
+        const given = new Set(value);
+        return shortenRows(value, ctx.step, shape).map((row) => (given.has(row) ? compactValue(row, schema?.items, ctx) : row));
     }
     if (value !== null && typeof value === 'object') {
-        return Object.fromEntries(Object.entries(value).map(([key, v]) => {
+        const object = value;
+        return Object.fromEntries(Object.entries(object).map(([key, v]) => {
             if (FIELD_KEYS.has(key))
                 return [key, v];
             if (key === 'shown' && Array.isArray(v))
-                return [key, shortenShown(v, limit)];
-            return [key, compactValue(v, limit)];
+                return [key, shortenShown(v, ctx.step)];
+            const child = schema?.properties?.[key];
+            const selection = child?.['x-rows']?.selection;
+            const chosen = selection && Array.isArray(object[selection]) ? object[selection].map(String) : [];
+            return [key, compactValue(v, child, ctx, chosen)];
         }));
     }
     return value;
@@ -137,28 +203,35 @@ function compactValue(value, limit) {
 const size = (value) => JSON.stringify(value).length;
 /**
  * The page state over budget, fitted step by step, cutting the least important
- * first. The surfaces are ordered by rank. Then long lists are shortened (20
- * rows, 10, 5, then only a count), on every other surface a step before the
- * surface the action acted on. Lists of five rows or fewer, every field, what is
- * unavailable or busy, the page's own facts and chosen rows are never shortened,
- * so the item open in a detail panel stays whole beside a long list. Then whole
- * surfaces are left out, the shells first, never the acting one. Only if that
- * still does not fit is the rest cut.
+ * first. The surfaces are ordered by rank. Then long lists are shortened: 20
+ * rows kept whole, then 10, 5, then none, the rest cut to index rows (what
+ * each is addressed and called by); then the index itself, to 100 rows, 40, 12
+ * and none, saying how the rest are read. Every other surface is a step ahead of
+ * the surface the action acted on. Lists of five rows or fewer, every field,
+ * what is unavailable or busy, the page's own facts and chosen rows are never
+ * shortened, so the item open in a detail panel and the layer just changed
+ * stay whole beside a long list. Then whole surfaces are left out, the shells
+ * first, never the acting one. Only if that still does not fit is the rest cut.
  */
-function fitted(observations, maxChars, acting) {
+function fitted(observations, maxChars, acting, options) {
     const base = Object.fromEntries(Object.entries(withoutKeptWhole(observations)).sort(([a], [b]) => surfaceRank(a, acting) - surfaceRank(b, acting)));
     const actingPresent = acting !== undefined && acting in base;
-    // Each step is (others' limit, the acting surface's limit): the acting one lags a step behind.
+    const changed = new Set(options.changed ?? []);
+    // Each step is (others' step, the acting surface's step): the acting one lags a step behind.
     const steps = [];
-    LIST_STEPS.forEach((limit, i) => {
+    LIST_STEPS.forEach((step, i) => {
         if (actingPresent && i > 0)
-            steps.push([limit, LIST_STEPS[i - 1]]);
-        steps.push([limit, limit]);
+            steps.push([step, LIST_STEPS[i - 1]]);
+        steps.push([step, step]);
     });
+    const fit = (surfaceId, value, step) => Object.fromEntries(Object.entries((value ?? {})).map(([observationId, v]) => [
+        observationId,
+        compactValue(v, options.schemas?.[surfaceId]?.[observationId], { step, changed }),
+    ]));
     let values = base;
     let listStep;
     for (const [others, own] of steps) {
-        values = Object.fromEntries(Object.entries(base).map(([id, v]) => [id, compactValue(v, id === acting ? own : others)]));
+        values = Object.fromEntries(Object.entries(base).map(([id, v]) => [id, fit(id, v, id === acting ? own : others)]));
         listStep = others;
         if (size(values) <= maxChars)
             return { values, listStep, omitted: [], fits: true };
@@ -179,11 +252,14 @@ function fitted(observations, maxChars, acting) {
 }
 /** What fitting did, in words. */
 function fitSummary(fit, maxChars, whole, acted) {
-    const lists = fit.listStep === undefined
+    const step = fit.listStep;
+    const lists = step === undefined
         ? ''
-        : fit.listStep === 0
-            ? `lists longer than ${WHOLE_LIST_ROWS} rows are given as a count`
-            : `long lists are shortened, to as few as ${Math.max(fit.listStep, WHOLE_LIST_ROWS)} rows, with how many more`;
+        : step.whole > 0
+            ? `long lists keep their first ${Math.max(step.whole, WHOLE_LIST_ROWS)} rows whole and the rest as index rows (what each is addressed and called by)`
+            : step.index > 0
+                ? `rows of lists longer than ${WHOLE_LIST_ROWS} are given as index rows (what each is addressed and called by)${Number.isFinite(step.index) ? `, the first ${step.index} of them` : ''}`
+                : `lists longer than ${WHOLE_LIST_ROWS} rows are given as a count, with how to read them`;
     const parts = [
         lists,
         'fields, the page’s own facts and chosen rows are kept whole',
@@ -198,16 +274,16 @@ function fitSummary(fit, maxChars, whole, acted) {
 /**
  * The observations as the model receives them: whole when they fit. Over
  * budget, every surface's problems and job statuses are kept whole; the rest is
- * fitted (see fitted): long lists shortened first, the page it acted on first
- * and kept whole, and only if that still does not fit is the rest cut, saying so.
+ * fitted (see fitted): long lists cut to index rows first, the page it acted on
+ * first and kept whole, and only if that still does not fit is the rest cut, saying so.
  */
-export function boundObservations(observations, maxChars, actingSurfaceId) {
+export function boundObservations(observations, maxChars, actingSurfaceId, options = {}) {
     const json = JSON.stringify(observations);
     if (json.length <= maxChars)
         return observations;
     const problems = surfaceProblems(observations);
     const jobs = jobStatuses(observations);
-    const fit = fitted(observations, maxChars, actingSurfaceId);
+    const fit = fitted(observations, maxChars, actingSurfaceId, options);
     const whole = [problems ? 'every surface’s problems' : '', jobs ? 'every job’s status' : ''].filter(Boolean);
     return {
         truncated: true,
@@ -218,13 +294,13 @@ export function boundObservations(observations, maxChars, actingSurfaceId) {
     };
 }
 /** The same, as the text of a `<page_state>` block. */
-export function observationsText(observations, maxChars) {
+export function observationsText(observations, maxChars, options = {}) {
     const json = JSON.stringify(observations);
     if (json.length <= maxChars)
         return json;
     const problems = surfaceProblems(observations);
     const jobs = jobStatuses(observations);
-    const fit = fitted(observations, maxChars, undefined);
+    const fit = fitted(observations, maxChars, undefined, options);
     const rest = JSON.stringify(fit.values);
     const head = (problems ? `Problems (in full): ${JSON.stringify(problems)}\n` : '') +
         (jobs ? `Jobs (in full): ${JSON.stringify(jobs)}\n` : '');