@genesislcap/ai-assistant 15.61.0 → 15.63.0

package/dist/esm/utils/context-tokens.js

@@ -1,3 +1,4 @@
+import { freshUserMessages, verbatimUserMessagesBlock } from './preserved-user-messages';
 /**
  * Context-window accounting (GENC-1567) — estimating how much of the model's
  * context each message occupies, so compaction can be sized in the unit that
@@ -191,27 +192,32 @@ const TEXT_ATTACHMENT_FRAMING_CHARS = 9;
  * `toolCall.subAgentTrace` is deliberately not counted either — it hangs off the
  * tool call for the UI's benefit and is never sent, so counting it would
  * attribute a whole sub-agent transcript to the parent's context.
+ *
+ * A compaction summary's kept user messages ARE counted: `normalizeForProvider`
+ * sends them, word for word, after the summary (GENC-1660, C2), and they can be
+ * the larger part of it — a pasted spec, every answer sent on the user's behalf.
  */
 function wireChars(m) {
-    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
-    let chars = (_b = (_a = m.content) === null || _a === void 0 ? void 0 : _a.length) !== null && _b !== void 0 ? _b : 0;
-    for (const attachment of (_c = m.attachments) !== null && _c !== void 0 ? _c : []) {
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l;
+    let chars = ((_b = (_a = m.content) === null || _a === void 0 ? void 0 : _a.length) !== null && _b !== void 0 ? _b : 0) +
+        verbatimUserMessagesBlock((_c = m.compaction) === null || _c === void 0 ? void 0 : _c.preservedUserMessages).length;
+    for (const attachment of (_d = m.attachments) !== null && _d !== void 0 ? _d : []) {
         if (attachment.kind === 'image')
             continue;
         chars +=
-            TEXT_ATTACHMENT_FRAMING_CHARS + attachment.name.length + ((_e = (_d = attachment.content) === null || _d === void 0 ? void 0 : _d.length) !== null && _e !== void 0 ? _e : 0);
+            TEXT_ATTACHMENT_FRAMING_CHARS + attachment.name.length + ((_f = (_e = attachment.content) === null || _e === void 0 ? void 0 : _e.length) !== null && _f !== void 0 ? _f : 0);
     }
-    for (const tc of (_f = m.toolCalls) !== null && _f !== void 0 ? _f : []) {
+    for (const tc of (_g = m.toolCalls) !== null && _g !== void 0 ? _g : []) {
         chars += tc.name.length;
         try {
-            chars += JSON.stringify((_g = tc.args) !== null && _g !== void 0 ? _g : {}).length;
+            chars += JSON.stringify((_h = tc.args) !== null && _h !== void 0 ? _h : {}).length;
         }
-        catch (_l) {
+        catch (_m) {
             // Circular or otherwise unserializable args: skip rather than throw. The
             // framing allowance below still counts the call itself.
         }
     }
-    chars += (_k = (_j = (_h = m.toolResult) === null || _h === void 0 ? void 0 : _h.content) === null || _j === void 0 ? void 0 : _j.length) !== null && _k !== void 0 ? _k : 0;
+    chars += (_l = (_k = (_j = m.toolResult) === null || _j === void 0 ? void 0 : _j.content) === null || _k === void 0 ? void 0 : _k.length) !== null && _l !== void 0 ? _l : 0;
     return chars;
 }
 /** Char-derived token estimate for one message, before any measured calibration. */
@@ -567,6 +573,12 @@ export function estimateRequestTokens(storedHistory, requestHistory, preambleTok
  *
  * The system preamble is carried across unchanged: compaction removes messages,
  * never the system prompt or the tool definitions.
+ *
+ * Besides the summary allowance, the summary carries the covered range's own user
+ * messages word for word (GENC-1660, C2), so those are priced too: a range that
+ * is mostly the user's own pastes reclaims far less than its size suggests. An
+ * earlier summary's kept messages are not carried forward (they fold into the new
+ * paraphrase), so they are reclaimed with the rest of the range.
  */
 export function projectCompaction(history, cut, summaryTokens = COMPACTION_SUMMARY_TOKEN_ESTIMATE, preambleTokens) {
     // One calibration for both figures, so `tokensBefore` is the same number the
@@ -576,8 +588,10 @@ export function projectCompaction(history, cut, summaryTokens = COMPACTION_SUMMA
     let tail = 0;
     for (let i = cut; i < estimates.length; i += 1)
         tail += estimates[i];
+    const kept = Math.ceil(verbatimUserMessagesBlock(freshUserMessages(history.slice(0, cut))).length /
+        APPROX_CHARS_PER_TOKEN);
     const tokensBefore = total;
-    const tokensAfter = overhead + summaryTokens + tail;
+    const tokensAfter = overhead + summaryTokens + kept + tail;
     return {
         cut,
         compactedCount: cut,

package/dist/esm/utils/delegated-message.js

@@ -12,6 +12,21 @@ export const isDelegated = (message) => !!message.delegate;
  * @beta
  */
 export const DEFAULT_DELEGATE_FRAMING = "Sent on the user's behalf.";
+/**
+ * The fields a delegated `user` message is stored with, from the options it was sent with: who sent
+ * it, the framing the model reads, and what writing it cost. Empty for the person's own message.
+ *
+ * @internal
+ */
+export function delegatedFields(options) {
+    var _a;
+    if (!(options === null || options === void 0 ? void 0 : options.delegate))
+        return {};
+    const cost = options.externalCostUsd;
+    return Object.assign({ delegate: options.delegate, delegateFraming: (_a = options.delegateFraming) !== null && _a !== void 0 ? _a : DEFAULT_DELEGATE_FRAMING }, (typeof cost === 'number' && Number.isFinite(cost) && cost > 0
+        ? { externalCostUsd: cost }
+        : {}));
+}
 /**
  * A delegated `user` message's content as the model reads it: its framing in brackets, then the
  * text. The one place this string is built, so the first model call (which takes the message as

package/dist/esm/utils/history-transform.js

@@ -1,6 +1,7 @@
 import { __rest } from "tslib";
 import { COMPACTION_SUMMARY_TOKEN_ESTIMATE, estimateMessageTokens, projectCompaction, reachesProvider, } from './context-tokens';
 import { frameDelegatedContent } from './delegated-message';
+import { preservedUserLine, verbatimUserMessagesBlock } from './preserved-user-messages';
 /**
  * Masks the tool-specific payload of a single message — clears tool call args
  * and replaces tool result content with a placeholder. Used when passing history
@@ -200,10 +201,15 @@ export function planCompaction(history, options = {}) {
 }
 /** One-line rendering of a message for the summarizer transcript. */
 function renderMessageForSummary(m) {
-    var _a;
+    var _a, _b, _c;
     switch (m.role) {
         case 'compacted-summary':
-            return `[Earlier summary] ${m.content}`;
+            // Its kept user messages too: a new compaction keeps only its own range's word for word, so
+            // the earlier ones survive by being folded into the new paraphrase (GENC-1660, C2).
+            return [
+                `[Earlier summary] ${m.content}`,
+                ...((_b = (_a = m.compaction) === null || _a === void 0 ? void 0 : _a.preservedUserMessages) !== null && _b !== void 0 ? _b : []).map((u) => `[Kept word for word with it] ${preservedUserLine(u)}`),
+            ].join('\n');
         case 'user':
             // A delegated message keeps its framing here too, or the summary would put words in the
             // user's mouth that outlive the message itself (GENC-1660).
@@ -220,7 +226,7 @@ function renderMessageForSummary(m) {
             if (m.category === 'narration') {
                 return m.content ? `Working: ${m.content}` : '';
             }
-            if ((_a = m.toolCalls) === null || _a === void 0 ? void 0 : _a.length) {
+            if ((_c = m.toolCalls) === null || _c === void 0 ? void 0 : _c.length) {
                 const calls = m.toolCalls.map((t) => t.name).join(', ');
                 return m.content
                     ? `Assistant: ${m.content} (called: ${calls})`
@@ -270,7 +276,7 @@ export function buildCompactionSummaryPrompt(toCompact) {
  */
 export function normalizeForProvider(history) {
     return history.map((m) => {
-        var _a;
+        var _a, _b, _c;
         // A user message sent on the user's behalf (GENC-1660) is framed, so the model never reads
         // it as something the person typed.
         if (m.role === 'user' && m.delegate) {
@@ -278,9 +284,14 @@ export function normalizeForProvider(history) {
         }
         if (m.role !== 'compacted-summary')
             return m;
-        return Object.assign(Object.assign({}, m), { role: 'user', content: `<conversation_summary>\n${m.content}\n</conversation_summary>\n\n` +
-                'The above summarizes earlier parts of this conversation that were compacted. ' +
-                'Continue naturally from it.', compaction: undefined });
+        // The user's own messages from the compacted range, word for word, so a paraphrase never
+        // stands in for what they actually said (GENC-1660, C2).
+        const preserved = (_c = (_b = m.compaction) === null || _b === void 0 ? void 0 : _b.preservedUserMessages) !== null && _c !== void 0 ? _c : [];
+        const verbatim = verbatimUserMessagesBlock(preserved);
+        return Object.assign(Object.assign({}, m), { role: 'user', content: `<conversation_summary>\n${m.content}\n</conversation_summary>${verbatim}\n\n` +
+                'The above summarizes earlier parts of this conversation that were compacted' +
+                (preserved.length ? ", with the user's own messages from them kept word for word" : '') +
+                '. Continue naturally from it.', compaction: undefined });
     });
 }
 /** Human-facing divider label for a `compacted-summary` message. */

package/dist/esm/utils/preserved-user-messages.js

@@ -0,0 +1,31 @@
+import { frameDelegatedContent } from './delegated-message';
+/**
+ * The user messages a compaction of `toCompact` keeps word for word (GENC-1660, critique C2): the
+ * range's own, oldest first, delegated ones still marked as such.
+ *
+ * Only the range's own. An earlier summary in the range is not carried forward: the summariser
+ * reads it with its own kept messages, and folds them into the new paraphrase. So the kept block
+ * never grows past one compaction's worth, at the cost of steering from before the previous
+ * compaction surviving only as paraphrase.
+ */
+export function freshUserMessages(toCompact) {
+    return toCompact.flatMap((m) => {
+        var _a;
+        return m.role === 'user' && ((_a = m.content) === null || _a === void 0 ? void 0 : _a.trim())
+            ? [
+                Object.assign(Object.assign({ content: m.content }, (m.timestamp ? { timestamp: m.timestamp } : {})), (m.delegate ? { delegate: m.delegate, delegateFraming: m.delegateFraming } : {})),
+            ]
+            : [];
+    });
+}
+/** One kept message as the model reads it: as the user, framed when it was sent on their behalf. */
+export const preservedUserLine = (u) => `User: ${u.delegate ? frameDelegatedContent(u.content, u.delegateFraming) : u.content}`;
+/**
+ * The kept user messages as the block that follows a summary on the wire, or `''` when there are
+ * none. The one place it is built, so what is sent and what the context estimate counts agree.
+ */
+export function verbatimUserMessagesBlock(preserved) {
+    if (!(preserved === null || preserved === void 0 ? void 0 : preserved.length))
+        return '';
+    return `\n\n<user_messages_verbatim>\n${preserved.map(preservedUserLine).join('\n')}\n</user_messages_verbatim>`;
+}

package/dist/react.cjs

@@ -6,6 +6,7 @@
 'use strict';
 
 const React = require('react');
+const { AutopilotHandBack: AutopilotHandBackWC } = require('./esm/autopilot/hand-back/hand-back.js');
 const { AiActivityHalo: AiActivityHaloWC } = require('./esm/components/activity-halo/activity-halo.js');
 const { AgentPicker: AgentPickerWC } = require('./esm/components/agent-picker/agent-picker.js');
 const { AiChatBubble: AiChatBubbleWC } = require('./esm/components/chat-bubble/chat-bubble.js');
@@ -82,6 +83,11 @@ const ChatSuggestions = React.forwardRef(function ChatSuggestions(props, ref) {
   return React.createElement(customElements.getName(ChatSuggestionsWC) ?? 'chat-suggestions', { ...rest, ref }, children);
 });
 
+const AutopilotHandBack = React.forwardRef(function AutopilotHandBack(props, ref) {
+  const { children, ...rest } = props;
+  return React.createElement(customElements.getName(AutopilotHandBackWC) ?? 'AUTOPILOT_HAND_BACK', { ...rest, ref }, children);
+});
+
 const AiActivityHalo = React.forwardRef(function AiActivityHalo(props, ref) {
   const { children, ...rest } = props;
   return React.createElement(customElements.getName(AiActivityHaloWC) ?? 'ai-activity-halo', { ...rest, ref }, children);
@@ -175,6 +181,7 @@ module.exports = {
   AiWavesIndicator,
   FoundationAiAssistant,
   ChatSuggestions,
+  AutopilotHandBack,
   AiActivityHalo,
   AgentPicker,
   AiChatBubble,

package/dist/react.mjs

@@ -4,6 +4,7 @@
  */
 
 import React from 'react';
+import { AutopilotHandBack as AutopilotHandBackWC } from './esm/autopilot/hand-back/hand-back.js';
 import { AiActivityHalo as AiActivityHaloWC } from './esm/components/activity-halo/activity-halo.js';
 import { AgentPicker as AgentPickerWC } from './esm/components/agent-picker/agent-picker.js';
 import { AiChatBubble as AiChatBubbleWC } from './esm/components/chat-bubble/chat-bubble.js';
@@ -80,6 +81,11 @@ export const ChatSuggestions = React.forwardRef(function ChatSuggestions(props,
   return React.createElement(customElements.getName(ChatSuggestionsWC) ?? 'chat-suggestions', { ...rest, ref }, children);
 });
 
+export const AutopilotHandBack = React.forwardRef(function AutopilotHandBack(props, ref) {
+  const { children, ...rest } = props;
+  return React.createElement(customElements.getName(AutopilotHandBackWC) ?? 'AUTOPILOT_HAND_BACK', { ...rest, ref }, children);
+});
+
 export const AiActivityHalo = React.forwardRef(function AiActivityHalo(props, ref) {
   const { children, ...rest } = props;
   return React.createElement(customElements.getName(AiActivityHaloWC) ?? 'ai-activity-halo', { ...rest, ref }, children);

package/docs/styling.md

@@ -266,7 +266,7 @@ one round-icon-button shape; the agent one additionally carries a label.
 | `composer-bar` | The control bar under the textarea |
 | `composer-bar-start` / `composer-bar-end` | The leading (agent / attach / ⋮) and trailing (Stop, Send) clusters |
 | `input` | The textarea |
-| `agent-toggle-button` | Agent button — an `A` glyph on Auto, the pinned agent's tinted pin otherwise |
+| `agent-toggle-button` | Agent button — a `sitemap` glyph under orchestration, the pinned agent's tinted pin otherwise |
 | `attach-button` | Attach (paperclip) |
 | `session-menu-button` | Session options (⋮) |
 | `stop-button` | Stop, shown only while a turn runs |

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@genesislcap/ai-assistant",
   "description": "Genesis AI Assistant micro-frontend",
-  "version": "15.61.0",
+  "version": "15.63.0",
   "license": "SEE LICENSE IN license.txt",
   "main": "dist/esm/index.js",
   "types": "dist/ai-assistant.d.ts",
@@ -92,31 +92,31 @@
     }
   },
   "devDependencies": {
-    "@genesislcap/foundation-comms": "15.61.0",
-    "@genesislcap/foundation-testing": "15.61.0",
-    "@genesislcap/genx": "15.61.0",
-    "@genesislcap/ts-builder": "15.61.0",
-    "@genesislcap/uvu-playwright-builder": "15.61.0",
-    "@genesislcap/vite-builder": "15.61.0",
-    "@genesislcap/webpack-builder": "15.61.0",
+    "@genesislcap/foundation-comms": "15.63.0",
+    "@genesislcap/foundation-testing": "15.63.0",
+    "@genesislcap/genx": "15.63.0",
+    "@genesislcap/ts-builder": "15.63.0",
+    "@genesislcap/uvu-playwright-builder": "15.63.0",
+    "@genesislcap/vite-builder": "15.63.0",
+    "@genesislcap/webpack-builder": "15.63.0",
     "@types/dompurify": "^3.0.5",
     "@types/marked": "^5.0.2",
     "esbuild": "0.25.12"
   },
   "dependencies": {
-    "@genesislcap/foundation-ai": "15.61.0",
-    "@genesislcap/foundation-logger": "15.61.0",
-    "@genesislcap/foundation-notifications": "15.61.0",
-    "@genesislcap/foundation-redux": "15.61.0",
-    "@genesislcap/foundation-ui": "15.61.0",
-    "@genesislcap/foundation-utils": "15.61.0",
-    "@genesislcap/rapid-design-system": "15.61.0",
-    "@genesislcap/web-core": "15.61.0",
+    "@genesislcap/foundation-ai": "15.63.0",
+    "@genesislcap/foundation-logger": "15.63.0",
+    "@genesislcap/foundation-notifications": "15.63.0",
+    "@genesislcap/foundation-redux": "15.63.0",
+    "@genesislcap/foundation-ui": "15.63.0",
+    "@genesislcap/foundation-utils": "15.63.0",
+    "@genesislcap/rapid-design-system": "15.63.0",
+    "@genesislcap/web-core": "15.63.0",
     "dompurify": "^3.3.1",
     "marked": "^17.0.3"
   },
   "peerDependencies": {
-    "@genesislcap/foundation-comms": "^15.61.0"
+    "@genesislcap/foundation-comms": "^15.63.0"
   },
   "peerDependenciesMeta": {
     "@genesislcap/foundation-comms": {

package/sandbox/README.md

@@ -30,12 +30,13 @@ The panel covers, roughly in the order you'll want them:
 | **Session menu (⋮)** | Whether a persistence provider is configured (the menu is gated on one) and `showSessionMenu`; a button to open the menu |
 | **Context window** | **Jump to state** (the four gate states in one click), the simulated window and fill, `chatConfig.context`, a flow-in-progress toggle, live readouts of the gate / thresholds / compaction plan, and Compact |
 | **Simulated state** | Forces `idle` / busy / cancelling / blocked / compacting / restoring onto the element |
+| **Autopilot** | The mode (unavailable / running / paused / self-paused), whether the agent hides the composer while working, the status text, "needs you", the collapsed bubble, a demo widget with a controller and who holds it, and the delegated mark |
 | **Transcript** | Seeds an empty, short, tool-and-markdown-heavy, 28-turn, ~20k-token, or ~22k-token tool-loop conversation, and how far back to shift its timestamps |
 | **Chrome** | Header title, popout mode, suggestions, the tool-call / reasoning / narration toggles, the timestamp mode, animations, per-reply thumbs (`messageFeedback`, with a stub send that succeeds or fails) |
 | **Stage** | Frame size (floored at 400px — see below), light/dark, remount, full reset |
 
-Panel state persists in `localStorage`, so a reload picks up where you left off. **Reset sandbox**
-clears it.
+Panel state persists in `localStorage`, so a reload picks up where you left off — including which
+groups are open. **Reset sandbox** clears both.
 
 ## The stub provider
 
@@ -165,6 +166,41 @@ a binding once and an idle conversation never re-renders — without it "2 minut
 still read "2 minutes ago" an hour later. The ticker only runs while the element is connected
 and the mode is not `off`.
 
+## Checking the autopilot UI (GENC-1660)
+
+Everything the person sees around the autopilot, without one: the slim bar in the composer's place,
+the hand-back banner inside a widget's own bubble, the halo staying on while the autopilot decides,
+the four states of a widget, the autopilot mark on what it did, and the "needs you" badge.
+
+Two stand-ins, both in `autopilot.ts`, and both reaching the element through its ordinary inputs:
+
+- **The host** is a stub `AutopilotHost`, set as the element's `autopilotHostOverride` — the input a
+  real host leaves alone, because the element finds the `AutopilotDriver` it installed itself. Its
+  buttons really move it: the **Autopilot** pill pauses it while it is on and resumes it while it
+  is off, **Keep paused** on the banner keeps it paused, and the **Mode** control follows the click.
+- **The demo widget** is Appendix A's confirm button: a registered widget with a DOM-free controller,
+  opened through the driver's `presentInteraction` as a tool would ask, and claimed by a real
+  interceptor on the element's own driver. **Demo widget held by** moves it through that interceptor's
+  real hold, so `heldBy` changes the way it does under the autopilot and the element decides what to
+  show for itself.
+
+| Control | What to look for |
+| --- | --- |
+| **Mode: Unavailable** | Today's UI, unchanged. Nothing autopilot-shaped anywhere. |
+| **Mode: Running** | While something is happening — **Simulated state: Busy**, or the demo widget open and held by the autopilot — the slim bar replaces the composer: the status, then the **Autopilot** pill on the right — filled like your own bubble while it is on, with the mark as its glyph and "Pause autopilot: …" as its tooltip — and **Stop** while busy. No text box, so nothing can be typed by accident. Idle (the state as it is after a wall such as the budget), the normal composer comes back with the pill filled among its pills, and no status. |
+| **Mode: Paused** | With **Agent hides the composer while working** on and the state Busy, the slim bar again, reading "Paused" with the pill unfilled. Turn the toggle off (or go idle) and the normal composer comes back with the pill after the agent picker, among the other pills — the autopilot never forces the composer open. |
+| **Hide composer** + **Mode: Running** or **Paused** | A host with no composer has no pills to put the **Autopilot** pill among, so the slim bar stays up whenever the autopilot is available — idle or not, running or paused — with its status and the pill, so the person can always see it is on and pause or resume it. |
+| **Mode: Self-paused** | With the state Busy, the slim bar reads "Waiting for your answer…" with the pill unfilled; its tooltip leads with "Resume autopilot and force it to decide this one". Open the demo widget: its bubble carries the banner, "I need your input on this one: …", with **Keep paused**. |
+| **Open the demo widget**, held by the autopilot | **Hidden** registration: no bubble at all, just the working indicator. **Visible**: the bubble stays and only its button goes, with a line saying the claimant holds it. |
+| **Held by: The person** | The widget comes back with its button, exactly as today. Press it to see the answered state. |
+| **Seed: Autopilot: delegated messages** | Narration before an answered widget, the "I chose" echo, and a written answer given on the user's behalf — every one on the assistant's side, with the mark beside the sender. **Delegated mark: None** removes the mark and nothing else. |
+| **Needs you** + **Show the collapsed bubble** | A badge on the orb, bottom right. Self-paused raises it too. |
+
+The **Element** readout is read off the element, not the panel: who holds the trailing interaction,
+the halo, and whether the slim bar is up. Set **Simulated state: Busy**, open the demo widget, and
+flip **Held by**: the halo stays on while the autopilot holds it and stops when the person does,
+because the assistant is only waiting when the person holds the question.
+
 ## 400px is the narrowest supported width
 
 The stage will not go below it — slider, drag handle and a restored panel state are all clamped —