@jxsuite/studio 3.0.0 → 4.0.0

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

@@ -41,6 +41,8 @@ import { renderMarkdown } from "./chat-markdown";
 import { summarizeWrites, writesForTurn } from "../../services/ai-writes";
 import { activeRegistry } from "../../commands/active-registry";
 
+import type { ImportRunRecord } from "../../services/import-run";
+
 // ─── Helpers (moved from ai-panel.ts) ────────────────────────────────────────
 
 /**
@@ -255,15 +257,93 @@ function renderUserMessage(msg: Message): TemplateResult {
   `;
 }
 
+/** The tool whose chip is a question card rather than a chip. */
+const ASK_TOOL = "ask_user";
+
+/** The tool whose chip grows a live progress line while it runs. */
+const IMPORT_TOOL = "import_site";
+
+/** Log lines drawn under a running import. The tail is what a reader wants. */
+/**
+ * How close to the bottom counts as "following along".
+ *
+ * The same threshold and the same reasoning as the transcript's own scroller
+ * (`panels/ai-panel.ts`): a reader who has scrolled up is reading something, and yanking them back
+ * on every new line is the behaviour that makes a live log unreadable.
+ */
+const IMPORT_STICK_THRESHOLD = 24;
+
 /**
- * What became of one tool call: `"pending"` while the loop has not reported, else ok/failed.
+ * Keep an import log pinned to its newest line, unless the reader has scrolled away from it.
+ *
+ * The log is a scroller now rather than a six-line tail, and a scroller that does not follow is a
+ * box that shows the same six lines it started with while the interesting ones pile up below.
+ */
+function stickToBottom(element: Element | undefined): void {
+  if (!(element instanceof HTMLElement)) {
+    return;
+  }
+  const distance = element.scrollHeight - element.scrollTop - element.clientHeight;
+  if (distance <= IMPORT_STICK_THRESHOLD || element.scrollTop === 0) {
+    element.scrollTop = element.scrollHeight;
+  }
+}
+
+/** What `ask_user` was called with, as far as the arguments actually parse. */
+interface AskArgs {
+  question: string;
+  options: string[];
+  context: string;
+}
+
+/**
+ * Read a question out of a tool call's arguments.
+ *
+ * Tolerant on purpose: the arguments are assembled from streamed fragments, so a chip can be asked
+ * to render a call whose JSON is still half-written. A card with an empty question renders as an
+ * ordinary chip rather than as an empty box.
  *
  * @param {ToolCallRecord} tc
- * @returns {"pending" | "ok" | "failed"}
+ * @returns {AskArgs | null}
  */
-export function toolOutcome(tc: ToolCallRecord): "pending" | "ok" | "failed" {
+export function parseAsk(tc: ToolCallRecord): AskArgs | null {
+  let parsed: { question?: unknown; options?: unknown; context?: unknown };
+  try {
+    parsed = tc.arguments ? (JSON.parse(tc.arguments) as typeof parsed) : {};
+  } catch {
+    return null; // Still streaming, or malformed — the generic chip is the honest fallback.
+  }
+  if (typeof parsed.question !== "string" || !parsed.question.trim()) {
+    return null;
+  }
+  return {
+    context: typeof parsed.context === "string" ? parsed.context : "",
+    options: Array.isArray(parsed.options)
+      ? parsed.options.filter((o): o is string => typeof o === "string" && o.trim().length > 0)
+      : [],
+    question: parsed.question,
+  };
+}
+
+/**
+ * What became of one tool call.
+ *
+ * `"unanswered"` is the fourth value and it exists for `ask_user`. A question's promise lives in
+ * memory, so a reload kills it while the transcript survives: without this the restored card is
+ * indistinguishable from a live one and spins forever waiting for a loop that is gone. It is a
+ * property of the RUN, not of the record, so the caller supplies whether this call is still live.
+ *
+ * @param {ToolCallRecord} tc
+ * @param {boolean} [live] - Whether the loop is still waiting on this call. Only consulted for a
+ *   result-less interactive call; every other pending call belongs to a turn still in flight.
+ * @returns {"pending" | "unanswered" | "ok" | "failed"}
+ */
+export function toolOutcome(
+  tc: ToolCallRecord,
+  live = true,
+): "pending" | "unanswered" | "ok" | "failed" {
   if (!tc.result) {
-    return "pending";
+    return tc.name === ASK_TOOL && !live ? "unanswered" : "pending";
   }
   return tc.result.success ? "ok" : "failed";
 }
@@ -286,27 +366,180 @@ export function toolOutcomeText(tc: ToolCallRecord): string {
   return (result.success ? result.summary : result.error) ?? "";
 }
 
-function renderToolChips(toolCalls: ToolCallRecord[]): TemplateResult | typeof nothing {
+/**
+ * A running import, under the chip that started it.
+ *
+ * An import takes minutes and says a line at a time. Rendering it here rather than in the modal it
+ * used to live in is what stops a successful run destroying its own account of what it did: the
+ * chip and the progress are one thing, joined by the tool-call id.
+ */
+function renderImportProgress(record: ImportRunRecord): TemplateResult {
+  const running = record.status === "running";
+  const determinate = record.total !== null && record.current !== null;
+  const outcome =
+    record.status === "done"
+      ? `Imported ${record.url}`
+      : record.status === "failed"
+        ? `Import failed — ${record.error || "the run did not say why"}`
+        : record.status === "stopped"
+          ? "Import stopped"
+          : record.message;
+  return html`
+    <details class="ai-import-progress" ?open=${running}>
+      <summary class="ai-import-head">
+        ${
+          running
+            ? determinate
+              ? html`<sp-progress-circle
+                  size="s"
+                  progress=${Math.round((record.current! / Math.max(record.total!, 1)) * 100)}
+                ></sp-progress-circle>`
+              : html`<sp-progress-circle indeterminate size="s"></sp-progress-circle>`
+            : nothing
+        }
+        ${running ? html`<span class="ai-import-phase">${record.phase}</span>` : nothing}
+        <span class="ai-import-message">${outcome}</span>
+        <span class="ai-import-count">${record.log.length}</span>
+      </summary>
+      <div class="ai-import-log" ${ref(stickToBottom)}>
+        ${repeat(
+          record.log,
+          (evt, index) => `${index}:${evt.phase}`,
+          (evt) => html`
+            <div class="ai-import-log-line">
+              <span class="ai-import-phase">${evt.phase}</span>${evt.message}
+            </div>
+          `,
+        )}
+      </div>
+    </details>
+  `;
+}
+
+/** How a question card reaches the store that resolves it. */
+export interface AskHandlers {
+  /** The id of the question the loop is still waiting on, or null. */
+  pendingId?: string | null;
+  onAnswer?: (text: string) => void;
+  onSkip?: () => void;
+  /** The live record for an `import_site` call, if this renderer's host has one. */
+  importRun?: (id: string) => ImportRunRecord | null;
+}
+
+/**
+ * A question, as the last thing in the transcript, waiting on the reader.
+ *
+ * The card IS the tool chip rather than a row beside it: the question, its options and its answer
+ * are all facts about one tool call, and rendering them anywhere else would give the transcript two
+ * accounts of the same event that can disagree after a reload.
+ *
+ * The options are a shortcut, never the whole answer — the composer is always live beneath, and its
+ * placeholder says so. A question whose real answer is "neither, do this instead" must stay
+ * answerable.
+ */
+function renderAskCard(
+  tc: ToolCallRecord,
+  ask: AskArgs,
+  outcome: ReturnType<typeof toolOutcome>,
+  handlers: AskHandlers,
+): TemplateResult {
+  const answered = tc.result?.success
+    ? ((tc.result.data as { answer?: string | null; skipped?: boolean } | undefined) ?? null)
+    : null;
+  return html`
+    <div class="ai-ask" data-outcome=${outcome}>
+      <div class="ai-ask-question">${ask.question}</div>
+      ${ask.context ? html`<div class="ai-ask-context">${ask.context}</div>` : nothing}
+      ${
+        outcome === "pending"
+          ? html`
+              <div class="ai-ask-options">
+                ${ask.options.map(
+                  (option) => html`
+                    <sp-button
+                      size="s"
+                      variant="secondary"
+                      treatment="outline"
+                      @click=${() => handlers.onAnswer?.(option)}
+                    >
+                      ${option}
+                    </sp-button>
+                  `,
+                )}
+                <sp-action-button
+                  size="s"
+                  quiet
+                  class="ai-ask-skip"
+                  title="Let the assistant decide"
+                  @click=${() => handlers.onSkip?.()}
+                >
+                  You decide
+                </sp-action-button>
+              </div>
+            `
+          : nothing
+      }
+      ${
+        outcome === "unanswered"
+          ? html`<div class="ai-ask-outcome">
+              This question was still open when the session was reloaded — reply below to carry on.
+            </div>`
+          : nothing
+      }
+      ${
+        answered
+          ? html`<div class="ai-ask-answer">
+              ${answered.skipped ? "You decide" : answered.answer}
+            </div>`
+          : nothing
+      }
+      ${
+        outcome === "failed"
+          ? html`<div class="ai-ask-outcome">${toolOutcomeText(tc)}</div>`
+          : nothing
+      }
+    </div>
+  `;
+}
+
+function renderToolChips(
+  toolCalls: ToolCallRecord[],
+  handlers: AskHandlers = {},
+): TemplateResult | typeof nothing {
   if (toolCalls.length === 0) {
     return nothing;
   }
   return html`
     <div class="ai-msg-tools">
       ${toolCalls.map((tc) => {
-        const outcome = toolOutcome(tc);
+        const ask = tc.name === ASK_TOOL ? parseAsk(tc) : null;
+        const outcome = toolOutcome(tc, tc.id === handlers.pendingId || Boolean(tc.result));
+        if (ask) {
+          return renderAskCard(tc, ask, outcome, handlers);
+        }
         const text = toolOutcomeText(tc);
+        /*
+         * For EVERY import chip, not only a running one.
+         *
+         * A finished run used to lose its whole account of itself at the instant it finished — the
+         * record was fetched only while the call was pending, so the log vanished on success. That
+         * is the failure the hand-off from the wizard to the assistant was made to fix, reproduced
+         * one layer in. It stays, collapsed, under the chip that produced it.
+         */
+        const run = tc.name === IMPORT_TOOL ? (handlers.importRun?.(tc.id) ?? null) : null;
         return html`
           <span class="ai-tool-chip" data-outcome=${outcome} title=${text || formatToolLabel(tc)}>
             <sp-icon-gears size="xs"></sp-icon-gears>
             <span class="ai-tool-chip-name">${formatToolLabel(tc)}</span>
             ${
-              outcome === "pending"
+              outcome === "pending" || outcome === "unanswered"
                 ? nothing
                 : html`<span class="ai-tool-chip-outcome"
                     >${outcome === "ok" ? "✓" : "✗"} ${text}</span
                   >`
             }
           </span>
+          ${run ? renderImportProgress(run) : nothing}
         `;
       })}
     </div>
@@ -373,6 +606,7 @@ function renderChangedFiles(
 function renderAssistantMessage(
   msg: Message,
   onRestore?: (messageId: string) => void,
+  ask: AskHandlers = {},
 ): TemplateResult | typeof nothing {
   const toolCalls = msg.toolCalls ?? [];
   if (!msg.content && toolCalls.length === 0) {
@@ -380,8 +614,8 @@ function renderAssistantMessage(
   }
   return html`
     <div class="ai-msg-assistant">
-      ${msg.content ? renderMarkdown(msg.id, msg.content) : nothing} ${renderToolChips(toolCalls)}
-      ${renderChangedFiles(msg, onRestore)}
+      ${msg.content ? renderMarkdown(msg.id, msg.content) : nothing}
+      ${renderToolChips(toolCalls, ask)} ${renderChangedFiles(msg, onRestore)}
     </div>
   `;
 }
@@ -396,7 +630,7 @@ function renderToolMessage(msg: Message): TemplateResult | typeof nothing {
   return html`<div class="ai-msg-tool-error">⚠️ ${parsed.error || "Tool call failed"}</div>`;
 }
 
-function renderStreamingTail(msg: Message): TemplateResult {
+function renderStreamingTail(msg: Message, ask: AskHandlers = {}): TemplateResult {
   if (!msg.content) {
     return html`
       <div class="ai-msg-typing">
@@ -409,7 +643,7 @@ function renderStreamingTail(msg: Message): TemplateResult {
   return html`
     <div class="ai-msg-assistant">
       <span class="ai-msg-streaming">${msg.content}</span>
-      ${renderToolChips(msg.toolCalls ?? [])}
+      ${renderToolChips(msg.toolCalls ?? [], ask)}
     </div>
   `;
 }
@@ -426,11 +660,19 @@ export interface MessageListOptions {
   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 outstanding question and how to settle it.
+   *
+   * Passed down rather than read from the store here, because this module renders templates and
+   * holds no state — the same reason the three header buttons are command records.
+   */
+  ask?: AskHandlers | undefined;
 }
 
 /** The scrollable message list — THE scroller of the chat view. */
 export function renderMessageList(opts: MessageListOptions): TemplateResult {
   const { messages, status } = opts;
+  const ask = opts.ask ?? {};
   const lastIdx = messages.length - 1;
   return html`
     <div class="ai-chat-messages" ${ref(opts.listRef)} @scroll=${opts.onScroll}>
@@ -462,9 +704,9 @@ export function renderMessageList(opts: MessageListOptions): TemplateResult {
           }
           if (msg.role === "assistant") {
             if (status === "streaming" && i === lastIdx) {
-              return renderStreamingTail(msg);
+              return renderStreamingTail(msg, ask);
             }
-            return renderAssistantMessage(msg, opts.onRestore);
+            return renderAssistantMessage(msg, opts.onRestore, ask);
           }
           return nothing;
         },

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

@@ -17,26 +17,17 @@
 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";
 import { getNodeAtPath } from "../../state";
-import {
-  aiConnection,
-  cachedModels,
-  fetchAvailableModels,
-  preferredModel,
-} from "../../services/ai-models";
-import { setModel } from "../../services/ai-settings";
+import { createModelPicker } from "../../ui/ai-model-picker";
 import { activeTab } from "../../workspace/workspace";
 import { primarySelection } from "../../tabs/selection";
 import { buildMessageWithContext } from "./attached-context";
 import type { ContextChip } from "./attached-context";
-import type { AiCredentials } from "../../services/ai-models";
 import type { JxMutableNode } from "@jxsuite/schema/types";
 
 /** Tallest the textarea auto-grows before it scrolls internally. */
 const MAX_INPUT_HEIGHT = 120;
-const RETRY_MODELS = "__retry_models__";
 
 export interface ComposerOptions {
   /** Receives the full message content (typed text + serialized context). */
@@ -45,6 +36,13 @@ export interface ComposerOptions {
   /** Opens the credentials form. */
   onOpenSettings: () => void;
   isStreaming: () => boolean;
+  /**
+   * Whether the turn is suspended on a question. The composer becomes the answer field: Enter still
+   * sends, but the host routes it to the pending question instead of opening a new turn.
+   *
+   * Optional so the evals harness and tests that predate `ask_user` keep compiling.
+   */
+  isAwaiting?: () => boolean;
   /** Host re-render scheduler — called whenever composer state changes. */
   requestRender: () => void;
 }
@@ -76,89 +74,10 @@ export function createComposer(opts: ComposerOptions): Composer {
   let hasText = false;
   let chips: ContextChip[] = [];
 
-  /** Null until the first fetch settles; kept on error so the picker can offer Retry. */
-  let modelsLoading = false;
-  let modelsError = "";
-
-  /**
-   * The connection the last fetch was made for, so a failure is not retried on every render.
-   *
-   * The list itself is NOT held here. A private copy is how the picker came to show one provider's
-   * catalogue while another was configured: it was filled once and never reconsidered. Reading it
-   * from `cachedModels(connection)` means a list can only ever be shown for the credentials it was
-   * listed under, and a credential change makes it unavailable rather than stale.
-   */
-  let attempted: AiCredentials | null = null;
-
-  // ── Model picker ──────────────────────────────────────────────────────
-
-  function sameConnection(a: AiCredentials | null, b: AiCredentials): boolean {
-    return a !== null && a.apiKey === b.apiKey && a.baseUrl === b.baseUrl;
-  }
-
-  function ensureModels(force = false) {
-    const credentials = aiConnection();
-    const settled = cachedModels(credentials) !== null || sameConnection(attempted, credentials);
-    if (modelsLoading || (settled && !force)) {
-      return;
-    }
-    modelsLoading = true;
-    modelsError = "";
-    attempted = credentials;
-    fetchAvailableModels({ credentials, force })
-      .catch((error: unknown) => {
-        modelsError = (error as Error).message || "Failed to fetch models";
-      })
-      .finally(() => {
-        modelsLoading = false;
-        opts.requestRender();
-      });
-  }
-
-  function onModelChange(e: Event) {
-    const { value } = e.target as HTMLInputElement;
-    if (value === RETRY_MODELS) {
-      attempted = null;
-      ensureModels(true);
-      // Re-render so the picker snaps back to the stored model instead of "Retry".
-      opts.requestRender();
-      return;
-    }
-    if (value) {
-      setModel(value);
-    }
-  }
-
-  function renderModelPicker(): TemplateResult {
-    ensureModels();
-    const current = preferredModel();
-    const listed = cachedModels(aiConnection()) ?? [];
-    const items = listed.some((m) => m.id === current)
-      ? listed
-      : [{ id: current, name: current }, ...listed];
-    return html`
-      <sp-picker
-        size="s"
-        quiet
-        class="ai-model-picker"
-        title=${modelsError ? `Couldn't load models: ${modelsError}` : "Model"}
-        .value=${live(current)}
-        @change=${onModelChange}
-      >
-        ${items.map((m) => html`<sp-menu-item value=${m.id}>${m.name}</sp-menu-item>`)}
-        ${
-          modelsLoading
-            ? html`<sp-menu-item disabled value="__loading__">Loading models…</sp-menu-item>`
-            : nothing
-        }
-        ${
-          modelsError
-            ? html`<sp-menu-item value=${RETRY_MODELS}>Retry loading models</sp-menu-item>`
-            : nothing
-        }
-      </sp-picker>
-    `;
-  }
+  /* The model picker is `ui/ai-model-picker.ts` now, not forty lines here: the New Project Import
+     source chooses a model too, and the "never hold the list privately" invariant is the kind that
+     only breaks in the copy nobody looked at. */
+  const modelPicker = createModelPicker({ requestRender: opts.requestRender });
 
   // ── Context attach ────────────────────────────────────────────────────
 
@@ -317,13 +236,18 @@ export function createComposer(opts: ComposerOptions): Composer {
 
   function render(): TemplateResult {
     const streaming = opts.isStreaming();
+    const awaiting = opts.isAwaiting?.() ?? false;
     return html`
-      <div class="ai-composer">
+      <div class="ai-composer" ?data-awaiting=${awaiting}>
         ${renderChips()}
         <textarea
           class="ai-composer-input"
           rows="1"
-          placeholder="Ask the assistant… (Enter to send)"
+          placeholder=${
+            awaiting
+              ? "Answer the assistant… (Enter to reply)"
+              : "Ask the assistant… (Enter to send)"
+          }
           ${ref((el) => {
             textareaEl = (el as HTMLTextAreaElement | null) || null;
           })}
@@ -331,7 +255,7 @@ export function createComposer(opts: ComposerOptions): Composer {
           @keydown=${onKeydown}
         ></textarea>
         <div class="ai-composer-row">
-          ${renderAttachMenu()} ${renderModelPicker()}
+          ${renderAttachMenu()} ${modelPicker.render()}
           <span class="ai-header-spacer"></span>
           <sp-action-button size="s" quiet title="API key & endpoint" @click=${opts.onOpenSettings}>
             <sp-icon-settings slot="icon"></sp-icon-settings>
@@ -347,7 +271,7 @@ export function createComposer(opts: ComposerOptions): Composer {
                   <sp-action-button
                     size="s"
                     class="ai-send-btn"
-                    title="Send"
+                    title=${awaiting ? "Answer" : "Send"}
                     ?disabled=${!hasText}
                     @click=${trySend}
                   >