@jxsuite/studio 2.0.0 → 2.1.0

package/src/panels/ai-chat/chat-view.ts

@@ -6,7 +6,27 @@
  * blocks become chips), assistant messages render sanitized markdown plus tool-call
  * chips, tool messages surface failures only (ADR §11.3), the streaming tail renders
  * as plain text with a cursor (markdown parses once on finalize), and chat errors get
- * a danger row with recovery advice. Pure templates — state lives in ai-panel.
+ * a danger row with recovery advice and a Retry. Templates only — chat state lives in ai-panel, and
+ * the three buttons are records the registry holds (see below).
+ *
+ * §7.4 (AI honesty) is why three things here are not what they were:
+ *
+ * - **A chip renders its OUTCOME.** `ToolCallRecord.result` has always been populated by the loop
+ *   and ignored by this renderer, so a chip that said `update_style: ["children",0]` said exactly
+ *   as much when the edit had been refused as when it had landed.
+ * - **A turn renders what it CHANGED.** The changed-files summary comes off the write ledger
+ *   (`services/ai-writes.ts`), which records whether each change went through a transaction or
+ *   straight to disk — so the undo caveat is rendered to the human holding ⌘Z instead of being
+ *   appended to the model-facing tool summary.
+ * - **An error offers Retry.** `chatState.retryLast()` has been implemented, exported and called by
+ *   nobody; the error row is where it belongs.
+ *
+ * §11.1 is why the three buttons here are not callbacks any more. History, New Chat and Retry were
+ * closures this module received and invoked, so the capabilities existed ONLY as buttons: the
+ * `Assistant` category held zero records, and nothing could reach them from the palette, a chord,
+ * the automation runner or the generated commands sheet. They run {@link commandButton} now, in the
+ * idiom `panels/statusbar.ts` established — the record is the definition site, and this file only
+ * decides where it is drawn.
  *
  * @license MIT
  */
@@ -17,6 +37,8 @@ import { ref } from "lit-html/directives/ref.js";
 import type { Message, ToolCallRecord } from "@jxsuite/ai/chat-state";
 import { splitAttachedContext } from "./attached-context";
 import { renderMarkdown } from "./chat-markdown";
+import { summarizeWrites, writesForTurn } from "../../services/ai-writes";
+import { activeRegistry } from "../../commands/active-registry";
 
 // ─── Helpers (moved from ai-panel.ts) ────────────────────────────────────────
 
@@ -89,33 +111,125 @@ export function formatErrorAdvice(error: string): string {
   return "";
 }
 
+// ─── Commands as buttons ────────────────────────────────────────────────────
+
+/** What {@link commandButton} draws inside the button, and how. */
+export interface CommandButtonOptions {
+  /** Slotted content — an icon element for the header, a label for the error row's Retry. */
+  content: TemplateResult | string;
+  /** Extra class, so the CSS that already targets `.ai-msg-retry` keeps landing. */
+  className?: string;
+  /** Quiet chrome. The header's icon buttons are quiet; the labelled Retry is not. */
+  quiet?: boolean;
+}
+
+/**
+ * One control that IS a command — `panels/statusbar.ts`'s `itemTpl`, for the assistant.
+ *
+ * A command the registry does not hold, or whose `when` is false, renders NOTHING rather than a
+ * dead button; a visible-but-refused one renders disabled with its `requires` sentence in the
+ * tooltip. That is what keeps this file a rendering of the registry instead of a second place the
+ * assistant's capabilities are decided — and it is why `tests/ai-chat-view.test.ts` asserts the
+ * ids, exactly as `tests/statusbar.test.ts` does: an id is not an interface between two files
+ * unless something checks it.
+ *
+ * Before any registry exists (the bootstrap composes one at the END of `studio.ts`, and a reduced
+ * test fixture may compose none) the button is simply absent. The chat is still readable, which is
+ * the same bargain the status bar strikes for the frame it paints early.
+ */
+export function commandButton(
+  id: string,
+  opts: CommandButtonOptions,
+): TemplateResult | typeof nothing {
+  const registry = activeRegistry();
+  const command = registry?.get(id);
+  if (!registry || !command || !registry.isVisible(id)) {
+    return nothing;
+  }
+  const reason = registry.disabledReason(id);
+  const chord = registry.keymap.formatBinding(id);
+  const title = reason
+    ? `${command.title} — requires ${reason}`
+    : chord
+      ? `${command.title} (${chord})`
+      : command.title;
+  return html`<sp-action-button
+    size="s"
+    ?quiet=${opts.quiet ?? false}
+    class=${opts.className ?? ""}
+    ?disabled=${reason !== undefined}
+    title=${title}
+    @click=${() => {
+      /* Re-asked at click time, not trusted from the render: state moves between the two, and
+         `registry.run` THROWS on a refusal. Same bargain `registry.handleKeyEvent` strikes for a
+         chord bound to a disabled command — swallow it here rather than make every surface wrap a
+         dispatch in try/catch. */
+      if (registry.isEnabled(id)) {
+        void registry.run(id);
+      }
+    }}
+  >
+    ${opts.content}
+  </sp-action-button>`;
+}
+
 // ─── Header ─────────────────────────────────────────────────────────────────
 
 export interface ChatHeaderOptions {
   /** The open session's title, or null for a fresh unsaved chat. */
   title: string | null;
   streaming: boolean;
-  onShowSessions: () => void;
-  onNewChat: () => void;
+  /**
+   * The conversation's estimated token count, and whether it is over the warning line.
+   *
+   * `services/context-manager.ts` has computed both on every turn since it was written, and
+   * `chat-state.ts` has stored them — with NO READER anywhere. Plan §11.6: "Context budget manager
+   * → tokenCount / contextWarning actually rendered". So a conversation was silently trimmed, the
+   * assistant forgot what you told it ten turns ago, and the two numbers that would have explained
+   * why sat in the store.
+   */
+  tokens: number;
+  overBudget: boolean;
+}
+
+/** Compact token count: 18400 → "18.4k". A four-digit number in a 28px header is noise. */
+function tokenLabel(tokens: number): string {
+  return tokens >= 1000 ? `${(tokens / 1000).toFixed(1)}k` : String(tokens);
 }
 
-/** The chat header: history button, session title, streaming spinner, New Chat. */
+/** The chat header: history button, session title, the context budget, spinner, New Chat. */
 export function renderChatHeader(opts: ChatHeaderOptions): TemplateResult {
   return html`
     <div class="ai-chat-header">
-      <sp-action-button size="s" quiet title="Chat history" @click=${opts.onShowSessions}>
-        <sp-icon-history slot="icon"></sp-icon-history>
-      </sp-action-button>
+      ${commandButton("assistant.history", {
+        content: html`<sp-icon-history slot="icon"></sp-icon-history>`,
+        quiet: true,
+      })}
       <span class="ai-chat-title">${opts.title ?? "New chat"}</span>
       <span class="ai-header-spacer"></span>
+      ${
+        opts.tokens > 0
+          ? html`<span
+              class=${opts.overBudget ? "ai-tokens ai-tokens--warn" : "ai-tokens"}
+              title=${
+                opts.overBudget
+                  ? `About ${opts.tokens.toLocaleString()} tokens — past half the model's context. ` +
+                    `The oldest turns are dropped as this grows; start a new chat to keep them.`
+                  : `About ${opts.tokens.toLocaleString()} tokens of the model's context in use`
+              }
+              >${tokenLabel(opts.tokens)}</span
+            >`
+          : nothing
+      }
       ${
         opts.streaming
           ? html`<sp-progress-circle size="s" indeterminate></sp-progress-circle>`
           : nothing
       }
-      <sp-action-button size="s" quiet title="New chat" @click=${opts.onNewChat}>
-        <sp-icon-add slot="icon"></sp-icon-add>
-      </sp-action-button>
+      ${commandButton("assistant.newChat", {
+        content: html`<sp-icon-add slot="icon"></sp-icon-add>`,
+        quiet: true,
+      })}
     </div>
   `;
 }
@@ -140,25 +254,125 @@ function renderUserMessage(msg: Message): TemplateResult {
   `;
 }
 
+/**
+ * What became of one tool call: `"pending"` while the loop has not reported, else ok/failed.
+ *
+ * @param {ToolCallRecord} tc
+ * @returns {"pending" | "ok" | "failed"}
+ */
+export function toolOutcome(tc: ToolCallRecord): "pending" | "ok" | "failed" {
+  if (!tc.result) {
+    return "pending";
+  }
+  return tc.result.success ? "ok" : "failed";
+}
+
+/**
+ * The one line a chip says about its outcome — the tool's own words where it has any.
+ *
+ * A tool that succeeded already writes a human sentence into `summary` for the model to read; there
+ * is no reason the human could not have been reading it all along. A tool that failed writes
+ * `error`, which was surfaced only through the separate tool-message row and only after the fact.
+ *
+ * @param {ToolCallRecord} tc
+ * @returns {string}
+ */
+export function toolOutcomeText(tc: ToolCallRecord): string {
+  const { result } = tc;
+  if (!result) {
+    return "";
+  }
+  return (result.success ? result.summary : result.error) ?? "";
+}
+
 function renderToolChips(toolCalls: ToolCallRecord[]): TemplateResult | typeof nothing {
   if (toolCalls.length === 0) {
     return nothing;
   }
   return html`
     <div class="ai-msg-tools">
-      ${toolCalls.map(
-        (tc) => html`
-          <span class="ai-tool-chip">
+      ${toolCalls.map((tc) => {
+        const outcome = toolOutcome(tc);
+        const text = toolOutcomeText(tc);
+        return html`
+          <span class="ai-tool-chip" data-outcome=${outcome} title=${text || formatToolLabel(tc)}>
             <sp-icon-gears size="xs"></sp-icon-gears>
-            ${formatToolLabel(tc)}
+            <span class="ai-tool-chip-name">${formatToolLabel(tc)}</span>
+            ${
+              outcome === "pending"
+                ? nothing
+                : html`<span class="ai-tool-chip-outcome"
+                    >${outcome === "ok" ? "✓" : "✗"} ${text}</span
+                  >`
+            }
           </span>
-        `,
-      )}
+        `;
+      })}
     </div>
   `;
 }
 
-function renderAssistantMessage(msg: Message): TemplateResult | typeof nothing {
+/**
+ * The turn's changed-files summary, with the two things it can honestly offer.
+ *
+ * Rendered only for a turn that changed something — "Changed 0 files" is noise, and a turn that
+ * only read is the common case. **Restore to here** is offered only when every recorded change went
+ * through a transaction: a disk write has no history behind it, so a button that claimed to restore
+ * one would be the same lie the model-facing caveat used to be.
+ */
+function renderChangedFiles(
+  msg: Message,
+  onRestore?: (messageId: string) => void,
+): TemplateResult | typeof nothing {
+  const writes = writesForTurn(msg.id);
+  if (writes.length === 0) {
+    return nothing;
+  }
+  const summary = summarizeWrites(writes);
+  if (!summary) {
+    return nothing;
+  }
+  const restorable = writes.every((w) => !w.disk);
+  return html`
+    <details class="ai-msg-changes">
+      <summary>
+        ${summary}
+        ${
+          onRestore && restorable
+            ? html`<sp-action-button
+                size="xs"
+                quiet
+                title="Undo everything this turn changed"
+                @click=${(e: Event) => {
+                  e.preventDefault();
+                  e.stopPropagation();
+                  onRestore(msg.id);
+                }}
+              >
+                Restore to here
+              </sp-action-button>`
+            : nothing
+        }
+      </summary>
+      <ul class="ai-msg-changes-list">
+        ${writes.map(
+          (w) => html`
+            <li data-disk=${String(w.disk)} data-ok=${String(w.ok)}>
+              <code>${w.path}</code>
+              <span>${w.ok ? w.tool : `failed — ${w.error ?? w.tool}`}</span>
+              ${w.disk ? html`<em>written to disk — undo cannot reach it</em>` : nothing}
+            </li>
+          `,
+        )}
+      </ul>
+    </details>
+  `;
+}
+
+function renderAssistantMessage(
+  msg: Message,
+  onRestore?: (messageId: string) => void,
+): TemplateResult | typeof nothing {
   const toolCalls = msg.toolCalls ?? [];
   if (!msg.content && toolCalls.length === 0) {
     return nothing;
@@ -166,6 +380,7 @@ function renderAssistantMessage(msg: Message): TemplateResult | typeof nothing {
   return html`
     <div class="ai-msg-assistant">
       ${msg.content ? renderMarkdown(msg.id, msg.content) : nothing} ${renderToolChips(toolCalls)}
+      ${renderChangedFiles(msg, onRestore)}
     </div>
   `;
 }
@@ -208,6 +423,8 @@ export interface MessageListOptions {
   onScroll: (e: Event) => void;
   /** Ref to the scrolling element, for stick-to-bottom maintenance. */
   listRef: (el: Element | undefined) => void;
+  /** Undo everything one turn changed. Offered only for turns whose changes are all transactional. */
+  onRestore?: ((messageId: string) => void) | undefined;
 }
 
 /** The scrollable message list — THE scroller of the chat view. */
@@ -237,7 +454,7 @@ export function renderMessageList(opts: MessageListOptions): TemplateResult {
           if (status === "streaming" && i === lastIdx) {
             return renderStreamingTail(msg);
           }
-          return renderAssistantMessage(msg);
+          return renderAssistantMessage(msg, opts.onRestore);
         }
         return nothing;
       })}
@@ -251,6 +468,16 @@ export function renderMessageList(opts: MessageListOptions): TemplateResult {
                     ? html`<div class="ai-msg-error-advice">${formatErrorAdvice(opts.error)}</div>`
                     : nothing
                 }
+                ${
+                  /* `assistant.retry`, not a closure. Its `enablement` reads `ctx.ai.configured`,
+                     so the one error this row cannot recover from — no provider connected, whose
+                     advice line above already says to add a key — draws the button disabled with
+                     that sentence rather than offering a send that will fail identically. */
+                  commandButton("assistant.retry", {
+                    className: "ai-msg-retry",
+                    content: "Retry",
+                  })
+                }
               </div>
             `
           : nothing

package/src/panels/ai-chat/composer.ts

@@ -15,6 +15,7 @@
  */
 
 import { html, nothing } from "lit-html";
+import { displayTagName } from "@jxsuite/schema/guards";
 import type { TemplateResult } from "lit-html";
 import { live } from "lit-html/directives/live.js";
 import { ref } from "lit-html/directives/ref.js";
@@ -22,10 +23,11 @@ import { getNodeAtPath } from "../../state";
 import { fetchAvailableModels } from "../../services/ai-models";
 import { getModel, setModel } from "../../services/ai-settings";
 import { activeTab } from "../../workspace/workspace";
+import { primarySelection } from "../../tabs/selection";
 import { buildMessageWithContext } from "./attached-context";
 import type { ContextChip } from "./attached-context";
 import type { AiModel } from "../../services/ai-models";
-import type { JxMutableNode, JxPath } from "@jxsuite/schema/types";
+import type { JxMutableNode } from "@jxsuite/schema/types";
 
 /** Tallest the textarea auto-grows before it scrolls internally. */
 const MAX_INPUT_HEIGHT = 120;
@@ -46,6 +48,16 @@ export interface Composer {
   render: () => TemplateResult;
   focus: () => void;
   clear: () => void;
+  /**
+   * Attach the canvas selection as a context chip, as the attach menu's second item does.
+   *
+   * `false` when nothing is selected, so a caller can say why nothing happened. This exists because
+   * `assistant.attachSelection` (`panels/ai-panel.ts`) must reach the SAME chip the menu builds —
+   * the attach convention is one delimiter and one `ContextChip` shape (`attached-context.ts`), and
+   * a command that assembled its own line would be a second way to say "this element", diverging
+   * the first time the label changes.
+   */
+  attachSelection: () => boolean;
 }
 
 /**
@@ -137,13 +149,17 @@ export function createComposer(opts: ComposerOptions): Composer {
   function contextCandidates() {
     const tab = activeTab.value;
     const documentPath = tab?.documentPath || null;
-    const selection = (tab?.session.selection as JxPath | null) || null;
+    const selection = primarySelection(tab?.session.selection);
     let selectionChip: ContextChip | null = null;
     if (tab && selection) {
+      /* No `tagName?: string` in this cast any more. It overrode the widened type — a tag may be
+         a name or a choice between names — so the compiler could not see that this chip would
+         render `[object Object]` for a chosen one. A cast that narrows a field back to what it
+         used to be is a hole the type system cannot report. */
       const node = getNodeAtPath(tab.doc.document as JxMutableNode, selection) as
-        | (JxMutableNode & { tagName?: string; textContent?: string })
+        | (JxMutableNode & { textContent?: string })
         | undefined;
-      const tag = node?.tagName || "element";
+      const tag = displayTagName(node?.tagName) || "element";
       const text = typeof node?.textContent === "string" ? node.textContent.slice(0, 40) : "";
       selectionChip = {
         detail: `Selected element at ${JSON.stringify(selection)}: <${tag}>${text ? ` "${text}"` : ""}`,
@@ -170,6 +186,16 @@ export function createComposer(opts: ComposerOptions): Composer {
     opts.requestRender();
   }
 
+  /** {@link Composer.attachSelection} — the attach menu's "Selected element" item, by name. */
+  function attachSelection(): boolean {
+    const { selectionChip } = contextCandidates();
+    if (!selectionChip) {
+      return false;
+    }
+    addChip(selectionChip);
+    return true;
+  }
+
   function renderAttachMenu(): TemplateResult {
     const { pageChip, selectionChip } = contextCandidates();
     return html`
@@ -317,5 +343,5 @@ export function createComposer(opts: ComposerOptions): Composer {
     `;
   }
 
-  return { clear, focus, render };
+  return { attachSelection, clear, focus, render };
 }

package/src/panels/ai-chat/sessions-view.ts

@@ -3,13 +3,21 @@
  * Sessions-view.js — the full-pane chat history list (VSCode-Copilot style).
  *
  * Renders the session rows (title, relative time, message count) with per-row delete,
- * a header with a New Chat action, and an empty state. Pure template functions — all
- * state and storage live in ai-panel / document-assistant.
+ * a header with a New Chat action, and an empty state. State and storage live in
+ * ai-panel / document-assistant; the row callbacks address ONE session each, which is
+ * why they stay callbacks.
+ *
+ * New Chat is the exception, and it is `assistant.newChat` — the same record the chat
+ * header runs ({@link commandButton}). The two headers draw the same button, so a
+ * second definition site is exactly how they would come to disagree about its name, its
+ * chord, or when it is offered.
  *
  * @license MIT
  */
 
 import { html } from "lit-html";
+import { now } from "../../services/clock";
+import { commandButton } from "./chat-view";
 import type { TemplateResult } from "lit-html";
 import type { SessionMeta } from "../../services/ai-session-store";
 
@@ -22,11 +30,11 @@ const DAY = 24 * HOUR;
  * date.
  *
  * @param {number} ts
- * @param {number} [now]
+ * @param {number} [at] Epoch milliseconds to measure against; defaults to the {@link now} seam.
  * @returns {string}
  */
-export function relativeTime(ts: number, now: number = Date.now()): string {
-  const delta = Math.max(0, now - ts);
+export function relativeTime(ts: number, at: number = now()): string {
+  const delta = Math.max(0, at - ts);
   if (delta < MINUTE) {
     return "just now";
   }
@@ -49,7 +57,6 @@ export interface SessionsListOptions {
   sessions: SessionMeta[];
   onOpen: (id: string) => void;
   onDelete: (id: string) => void;
-  onNew: () => void;
 }
 
 function renderRow(s: SessionMeta, opts: SessionsListOptions): TemplateResult {
@@ -84,10 +91,10 @@ export function renderSessionsList(opts: SessionsListOptions): TemplateResult {
     <div class="ai-chat-header">
       <span class="ai-chat-title">Chats</span>
       <span class="ai-header-spacer"></span>
-      <sp-action-button size="s" quiet title="New chat" @click=${opts.onNew}>
-        <sp-icon-add slot="icon"></sp-icon-add>
-        New Chat
-      </sp-action-button>
+      ${commandButton("assistant.newChat", {
+        content: html`<sp-icon-add slot="icon"></sp-icon-add>New Chat`,
+        quiet: true,
+      })}
     </div>
     <div class="ai-sessions">
       ${