@jskit-ai/assistant-core 0.1.169 → 0.1.171

package/examples/conversation/package.json

@@ -8,9 +8,9 @@
     "build": "vite build"
   },
   "dependencies": {
-    "@jskit-ai/assistant-core": "0.1.169",
-    "@jskit-ai/http-runtime": "0.1.189",
-    "@jskit-ai/kernel": "0.1.191",
+    "@jskit-ai/assistant-core": "0.1.171",
+    "@jskit-ai/http-runtime": "0.1.191",
+    "@jskit-ai/kernel": "0.1.193",
     "@mdi/js": "^7.4.47",
     "vue": "^3.5.13",
     "vuetify": "^4.0.0"

package/fixtures/responsive-assistant/App.vue

@@ -1,106 +1,44 @@
 <script setup>
 import { computed, ref } from "vue";
-import AssistantClientElement from "../../src/client/components/AssistantClientElement.vue";
-
-const longConversation = Array.from(
-  { length: 90 },
-  (_, index) => `Conversation line ${index + 1}: responsive scroll containment must keep the composer visible.`
-).join("\n\n");
-
-const messages = ref([
-  {
-    id: "message-1",
-    role: "assistant",
-    kind: "chat",
-    status: "completed",
-    text: longConversation
+import AssistantConversationElement from "../../src/client/conversation/AssistantConversationElement.vue";
+import { conversationTurnsFromMessages } from "../../src/shared/conversation/turns.js";
+const draft = ref("");
+const controls = new URLSearchParams(location.search).has("controls");
+const scope = ref("one");
+const messages = ref(Array.from({ length: 70 }, (_, index) => ({
+  id: `message-${index}`, role: index % 2 ? "assistant" : "user", status: "completed",
+  text: `Conversation line ${index + 1}: responsive scroll containment keeps the composer visible.\n\nMore text with **formatting**, a [link](https://example.com), and a_long_word_that_must_wrap_in_narrow_panes_without_overflow.`
+})));
+if (controls) messages.value[0].text = messages.value[0].text.repeat(4);
+const adapter = computed(() => ({
+  conversation: { turns: conversationTurnsFromMessages(messages.value), scrollKey: scope.value, hasMoreBefore: controls },
+  composer: { draft: draft.value, canSend: Boolean(draft.value.trim()), rows: 2 },
+  actions: {
+    setDraft(value) { draft.value = value; },
+    submit() { draft.value = ""; },
+    loadMore({ complete }) {
+      messages.value.unshift({ id: "older", role: "assistant", text: "Older conversation paragraph. ".repeat(40), status: "completed" });
+      complete({ changed: true });
+    }
   }
-]);
-const input = ref("");
-const isStreaming = ref(false);
-const isRestoringConversation = ref(false);
-const conversationId = ref("conversation-1");
-const conversationHistory = ref([
-  {
-    id: "conversation-1",
-    title: "Responsive layout regression",
-    status: "completed",
-    startedAt: "2026-08-24T00:00:00.000Z",
-    messageCount: 1
-  }
-]);
-const conversationHistoryLoading = ref(false);
-const conversationHistoryLoadingMore = ref(false);
-const conversationHistoryHasMore = ref(false);
-const conversationHistoryError = ref("");
-const pendingToolEvents = ref([
-  {
-    id: "tool-1",
-    name: "assistant_action_search",
-    status: "completed"
-  }
-]);
-
-const state = Object.freeze({
-  messages,
-  input,
-  isStreaming,
-  isRestoringConversation,
-  pendingToolEvents,
-  conversationId,
-  conversationHistory,
-  conversationHistoryLoading,
-  conversationHistoryLoadingMore,
-  conversationHistoryHasMore,
-  conversationHistoryError,
-  isAdminSurface: ref(false),
-  canSend: computed(() => input.value.trim().length > 0),
-  canStartNewConversation: ref(true)
-});
-
-const actions = Object.freeze({
-  async sendMessage() {},
-  handleInputKeydown() {},
-  async cancelStream() {},
-  async startNewConversation() {},
-  async selectConversation() {},
-  async refreshConversationHistory() {},
-  async loadMoreConversationHistory() {}
-});
-
-const meta = Object.freeze({
-  formatConversationStartedAt() {
-    return "Aug 24, 2026";
-  }
-});
+}));
 </script>
-
 <template>
   <v-app>
     <v-main>
       <main class="assistant-responsive-fixture">
-        <AssistantClientElement
-          :meta="meta"
-          :state="state"
-          :actions="actions"
-          :viewer="{ displayName: 'Ada Lovelace' }"
-        />
+        <nav v-if="controls">
+          <button @click="scope = scope === 'one' ? 'two' : 'one'">Change conversation</button>
+          <button @click="messages.push({ id: `added-${messages.length}`, role: 'assistant', text: 'New reply. '.repeat(30), status: 'completed' })">Append reply</button>
+        </nav>
+        <AssistantConversationElement :adapter="adapter" class="assistant-responsive-fixture__conversation" />
       </main>
     </v-main>
   </v-app>
 </template>
-
 <style>
-html,
-body,
-#app {
-  block-size: 100%;
-  margin: 0;
-  min-block-size: 0;
-}
-
-.assistant-responsive-fixture {
-  block-size: 100%;
-  min-block-size: 0;
-}
+html, body, #app { height: 100%; margin: 0; min-height: 0; }
+.assistant-responsive-fixture { display: flex; flex-direction: column; height: 100dvh; min-height: 0; padding: .5rem; }
+.assistant-responsive-fixture nav { display: flex; flex: 0 0 auto; gap: 1rem; }
+.assistant-responsive-fixture__conversation { flex: 1 1 auto; }
 </style>

package/fixtures/responsive-assistant/ConversationFixture.vue

@@ -5,11 +5,13 @@ const phase = ref("idle");
 const draft = ref("");
 const narrow = ref(false);
 const submissions = ref(0);
+const feedback = ref(false);
 const adapter = reactive({
   conversation: { turns: [], visible: true, scrollKey: "fixture", welcomeMessage: "Composer responsiveness fixture" },
   composer: {
     draft,
     rows: 2,
+    density: computed(() => narrow.value ? "compact" : "default"),
     submitOnEnter: true,
     canSend: computed(() => Boolean(draft.value.trim()) && ["idle", "active", "stopped"].includes(phase.value)),
     canStop: computed(() => ["active", "stopping"].includes(phase.value)),
@@ -29,10 +31,13 @@ const adapter = reactive({
       <div class="controls">
         <button v-for="state in ['idle', 'active', 'reconnecting', 'stopping', 'stopped']" :key="state" @click="phase = state">External {{ state }}</button>
         <button @click="narrow = !narrow">Resize pane</button>
+        <button @click="feedback = !feedback">Toggle action feedback</button>
         <output>{{ phase }}; submitted {{ submissions }}</output>
       </div>
       <main class="fixture" :class="{ narrow }">
-        <AssistantConversationElement :adapter="adapter" />
+        <AssistantConversationElement :adapter="adapter">
+          <template #composer-feedback><p v-if="feedback" class="feedback" role="status">Describe what you want to change.</p></template>
+        </AssistantConversationElement>
       </main>
     </v-main>
   </v-app>
@@ -42,4 +47,5 @@ const adapter = reactive({
 .controls button { border: 1px solid; padding: 4px; }
 .fixture { height: 70vh; width: min(900px, 100%); margin: auto; }
 .fixture.narrow { width: min(320px, 100%); }
+.feedback { flex: 1 1 24rem; min-width: 0; margin: 0; }
 </style>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jskit-ai/assistant-core",
-  "version": "0.1.169",
+  "version": "0.1.171",
   "type": "module",
   "scripts": {
     "test": "node --test"
@@ -21,18 +21,16 @@
     "./testing/conversation-storage": "./src/testing/conversationStorageContract.js"
   },
   "dependencies": {
-    "@jskit-ai/resource-core": "0.1.133",
-    "@jskit-ai/resource-crud-core": "0.1.133",
-    "dompurify": "^3.4.13",
+    "@jskit-ai/resource-core": "0.1.135",
+    "@jskit-ai/resource-crud-core": "0.1.135",
     "json-rest-schema": "^1.0.17",
-    "marked": "^17.0.4",
     "openai": "^6.22.0",
     "@mdi/js": "^7.4.47",
     "ws": "^8.20.1"
   },
   "peerDependencies": {
-    "@jskit-ai/http-runtime": "0.1.189",
-    "@jskit-ai/kernel": "0.1.191",
+    "@jskit-ai/http-runtime": "0.1.191",
+    "@jskit-ai/kernel": "0.1.193",
     "vue": "^3.5.13",
     "vuetify": "^4.0.0"
   },

package/src/client/conversation/AssistantComposerActions.vue

@@ -1,5 +1,5 @@
 <template>
-  <div class="assistant-composer-actions">
+  <div class="assistant-composer-actions" :class="{ 'assistant-composer-actions--compact': state.density === 'compact' }">
     <div class="assistant-composer-actions__tools"><slot /></div>
     <div class="assistant-composer-actions__delivery">
       <v-btn
@@ -18,6 +18,7 @@
         {{ state.submitLabel || (state.pending ? 'Sending…' : 'Send') }}
       </v-btn>
     </div>
+    <slot name="feedback" />
   </div>
 </template>
 <script setup>
@@ -36,7 +37,8 @@ defineExpose({ focus() { (sendButton.value?.$el || sendButton.value)?.focus?.();
 .assistant-composer-actions__tools { flex: 1 1 auto; flex-wrap: wrap; }
 .assistant-composer-actions__delivery { flex: 0 0 auto; margin-left: auto; }
 .assistant-composer-actions__send { min-width: 5.25rem; }
-@media (pointer: coarse) {
+.assistant-composer-actions--compact .assistant-composer-actions__delivery > .v-btn { min-height: 3rem; }
+@media (max-width: 600px), (pointer: coarse) {
   .assistant-composer-actions__delivery > .v-btn { min-height: 3rem; min-width: 3rem; }
   .assistant-composer-actions__delivery > .assistant-composer-actions__send { min-width: 5.25rem; }
 }

package/src/client/conversation/AssistantConversationElement.vue

@@ -11,7 +11,7 @@
     <slot name="hints" :adapter="adapter" />
     <slot name="composer" :adapter="adapter">
       <AssistantPromptInput
-        v-if="adapter.composer" ref="input" v-bind="adapter.composer"
+        v-if="adapter.composer" ref="input" v-bind="adapter.composer" class="assistant-conversation__composer"
         :model-value="adapter.composer.draft || ''" :submit-enabled="adapter.composer.canSend"
         :aria-label="adapter.composer.ariaLabel || 'Message AI assistant'" :rows="adapter.composer.rows || 2"
         tab-to-submit @update:model-value="adapter.actions.setDraft($event)"
@@ -34,6 +34,7 @@
               />
             </slot>
             <slot name="composer-tools" :adapter="adapter" />
+            <template #feedback><slot name="composer-feedback" :adapter="adapter" /></template>
           </AssistantComposerActions>
         </template>
       </AssistantPromptInput>
@@ -53,7 +54,7 @@ const props = defineProps({
   configurationMode: { type: String, default: "hidden", validator: (value) => ["hidden", "readonly", "editable"].includes(value) }
 });
 const slots = useSlots();
-const transcriptSlots = computed(() => ["attachments", "system-message", "message-actions"].filter((name) => slots[name]));
+const transcriptSlots = computed(() => ["welcome", "attachments", "system-message", "message-actions"].filter((name) => slots[name]));
 const input = ref(null);
 const delivery = ref(null);
 function submit() {
@@ -74,5 +75,6 @@ defineExpose({ focus: () => input.value?.focus(), submit, stop });
 <style scoped>
 .assistant-conversation { display: flex; flex-direction: column; min-height: 0; min-width: 0; height: 100%; gap: 0; }
 .assistant-conversation__transcript { flex: 1 1 auto; min-height: 0; }
+.assistant-conversation__composer { flex: 0 0 auto; }
 .assistant-conversation__setting { min-width: 8rem; max-width: 16rem; }
 </style>

package/src/client/conversation/AssistantTranscript.vue

@@ -72,7 +72,7 @@
             <span>{{ assistantLabel }}</span>
           </div>
         </div>
-        <p>{{ welcomeMessage }}</p>
+        <slot name="welcome"><p>{{ welcomeMessage }}</p></slot>
       </div>
 
       <div
@@ -873,6 +873,11 @@ onBeforeUnmount(() => {
   clearLoadMoreScrollSnapshot();
 });
 
+watch(() => props.scrollKey, () => {
+  expandedUserMessages.value = new Set();
+  displayMessageCache.clear();
+});
+
 watch(() => [
   timelineScrollTrigger.value,
   latestRenderedTailKey.value
@@ -1073,21 +1078,21 @@ watch(timelineScrollTrigger, () => {
 }
 
 .assistant-transcript__avatar--user {
-  background: #e9f2fc;
-  color: #2f79ca;
+  background: rgba(var(--v-theme-primary), 0.1);
+  color: rgb(var(--v-theme-primary));
   margin-top: 0.2rem;
 }
 
 .assistant-transcript__avatar--assistant {
-  background: #5b9ce1;
-  color: #ffffff;
+  background: rgb(var(--v-theme-primary));
+  color: rgb(var(--v-theme-on-primary));
   margin-top: 0.05rem;
 }
 
 .assistant-transcript__message--user {
-  background: #e3ebf5;
+  background: rgba(var(--v-theme-primary), 0.1);
   border-radius: 16px;
-  color: #202936;
+  color: rgb(var(--v-theme-on-surface));
   gap: 0.75rem;
   justify-content: space-between;
   overflow-x: auto;

package/src/client/index.js

@@ -1,5 +1,3 @@
-export { default as AssistantClientElement } from "./components/AssistantClientElement.vue";
 export { default as AssistantSettingsFormCard } from "./components/AssistantSettingsFormCard.vue";
 export { assistantHttpClient } from "./lib/assistantHttpClient.js";
 export { createAssistantApi, buildStreamEventError } from "./lib/assistantApi.js";
-export { renderMarkdownToSafeHtml } from "./lib/markdownRenderer.js";

package/test/assistantScroll.browser.test.js

@@ -14,94 +14,31 @@ const TEST_DIRECTORY = path.dirname(fileURLToPath(import.meta.url));
 const FIXTURE_ROOT = path.resolve(TEST_DIRECTORY, "../fixtures/responsive-assistant");
 const RUN_BROWSER_TEST = process.env.JSKIT_ASSISTANT_CORE_BROWSER_INTEGRATION === "1";
 const VIEWPORTS = Object.freeze([
-  Object.freeze({ name: "phone", width: 390, height: 844, sidePanelsVisible: false }),
-  Object.freeze({ name: "compact", width: 800, height: 900, sidePanelsVisible: false }),
-  Object.freeze({ name: "medium", width: 1224, height: 900, sidePanelsVisible: true }),
-  Object.freeze({ name: "expanded", width: 1365, height: 900, sidePanelsVisible: true })
+  Object.freeze({ name: "phone", width: 390, height: 844 }),
+  Object.freeze({ name: "compact", width: 800, height: 900 }),
+  Object.freeze({ name: "medium", width: 1224, height: 900 }),
+  Object.freeze({ name: "expanded", width: 1365, height: 900 }),
+  Object.freeze({ name: "short", width: 1280, height: 600 }),
+  Object.freeze({ name: "drawer", width: 360, height: 600 })
 ]);
 
-async function readLayoutMetrics(page) {
-  return page.evaluate(() => {
-    const root = document.querySelector(".assistant-client-element");
-    const layout = document.querySelector(".assistant-layout");
-    const mainColumn = document.querySelector(".assistant-main-col");
-    const sideColumn = document.querySelector(".assistant-side-col");
-    const messages = document.querySelector(".messages-panel");
-    const composer = document.querySelector(".assistant-composer-shell");
-    const history = document.querySelector(".assistant-history-card");
-    const tools = document.querySelector(".assistant-tools-card");
-    const rect = (element) => element?.getBoundingClientRect() || null;
-
-    return {
-      viewportHeight: window.innerHeight,
-      documentOverflow: document.documentElement.scrollWidth - document.documentElement.clientWidth,
-      root: rect(root),
-      layout: rect(layout),
-      mainColumn: rect(mainColumn),
-      sideColumn: rect(sideColumn),
-      messages: {
-        ...rect(messages),
-        clientHeight: messages?.clientHeight || 0,
-        scrollHeight: messages?.scrollHeight || 0,
-        scrollTop: messages?.scrollTop || 0
-      },
-      composer: rect(composer),
-      sideColumnDisplay: sideColumn ? window.getComputedStyle(sideColumn).display : "missing",
-      historyDisplay: history ? window.getComputedStyle(history).display : "missing",
-      toolsDisplay: tools ? window.getComputedStyle(tools).display : "missing"
-    };
-  });
-}
-
 async function assertResponsiveAssistant(page, viewport) {
   await page.setViewportSize({ width: viewport.width, height: viewport.height });
-  await page.goto("/", { waitUntil: "networkidle" });
-
-  const root = page.getByTestId("assistant-client-element");
-  const messages = page.getByTestId("assistant-messages-panel");
-  const compactConversationControl = page.getByRole("button", { name: "Conversations", exact: true });
-  await root.waitFor({ state: "visible" });
-
-  const metrics = await readLayoutMetrics(page);
-  assert.ok(
-    metrics.messages.scrollHeight > metrics.messages.clientHeight,
-    `${viewport.name}: messages did not become an internal scroll container.`
-  );
-  assert.ok(metrics.composer, `${viewport.name}: composer was not rendered.`);
-  assert.ok(
-    metrics.composer.bottom <= metrics.viewportHeight + 1,
-    `${viewport.name}: composer bottom ${metrics.composer.bottom}px exceeded the ${metrics.viewportHeight}px viewport.`
-  );
-  assert.ok(
-    metrics.root.bottom <= metrics.viewportHeight + 1,
-    `${viewport.name}: assistant root escaped the viewport.`
-  );
-  assert.ok(
-    metrics.mainColumn.bottom <= metrics.root.bottom + 1,
-    `${viewport.name}: main column escaped its bounded root.`
-  );
-  assert.ok(metrics.documentOverflow <= 1, `${viewport.name}: page overflowed horizontally.`);
-
-  if (viewport.sidePanelsVisible) {
-    assert.equal(metrics.sideColumnDisplay, "flex", `${viewport.name}: sidebar column was hidden.`);
-    assert.equal(metrics.historyDisplay, "flex", `${viewport.name}: conversation history was hidden.`);
-    assert.equal(metrics.toolsDisplay, "flex", `${viewport.name}: tool timeline was hidden.`);
-    await expect(compactConversationControl).toBeHidden();
-  } else {
-    assert.equal(metrics.sideColumnDisplay, "none", `${viewport.name}: sidebar column still occupied the layout.`);
-    await expect(compactConversationControl).toBeVisible();
-  }
-
-  await messages.evaluate((element) => {
-    element.scrollTop = 0;
-    element.dispatchEvent(new Event("scroll"));
-  });
-  await messages.hover();
-  await page.mouse.wheel(0, 420);
-  await expect.poll(() => messages.evaluate((element) => element.scrollTop)).toBeGreaterThan(0);
+  await page.goto("/");
+  const input = page.getByRole("textbox", { name: "Message AI assistant" });
+  await expect(input).toBeVisible();
+  const body = page.locator(".assistant-transcript__body");
+  await expect(page.getByText("Conversation line 70:", { exact: false })).toBeAttached();
+  await expect.poll(() => body.evaluate((element) => element.scrollHeight > element.clientHeight)).toBe(true);
+  const bounds = await input.boundingBox();
+  assert.ok(bounds.y + bounds.height <= viewport.height);
+  assert.ok(await page.evaluate(() => document.documentElement.scrollWidth <= innerWidth));
+  await body.hover();
+  await page.mouse.wheel(0, -600);
+  await expect.poll(() => body.evaluate((element) => element.scrollHeight - element.clientHeight - element.scrollTop)).toBeGreaterThan(100);
 }
 
-test("AssistantClientElement keeps long conversations scrollable across responsive layouts", {
+test("AssistantConversationElement keeps long conversations scrollable across responsive layouts", {
   skip: RUN_BROWSER_TEST
     ? false
     : "set JSKIT_ASSISTANT_CORE_BROWSER_INTEGRATION=1 to run assistant-core browser integration",
@@ -138,6 +75,45 @@ test("AssistantClientElement keeps long conversations scrollable across responsi
   }
 });
 
+test("conversation scrolling preserves history anchors and resets expansion on selection", {
+  skip: !RUN_BROWSER_TEST,
+  timeout: 60_000
+}, async () => {
+  const vite = await startViteFixture({ fixtureRoot: FIXTURE_ROOT });
+  const browser = await chromium.launch(createChromiumLaunchOptions());
+  try {
+    const page = await browser.newPage();
+    await page.goto(`${vite.baseURL}/?controls=1`);
+    const body = page.locator(".assistant-transcript__body");
+    await expect(page.getByText("Conversation line 70:", { exact: false })).toBeVisible();
+    await body.hover();
+    await page.mouse.wheel(0, -100_000);
+    await expect.poll(() => body.evaluate((element) => element.scrollTop)).toBe(0);
+    await page.getByRole("button", { name: "Read more", exact: true }).click();
+    await expect(page.getByRole("button", { name: "Show less", exact: true })).toBeVisible();
+    const original = page.getByText("Conversation line 1:", { exact: false }).first();
+    const originalTop = (await original.boundingBox()).y;
+    await page.getByRole("button", { name: "Load older messages", exact: true }).click();
+    await expect.poll(async () => Math.abs((await original.boundingBox()).y - originalTop)).toBeLessThan(2);
+    const before = await body.evaluate((element) => element.scrollTop);
+    await page.getByRole("button", { name: "Append reply", exact: true }).click();
+    await expect(page.getByText("New reply.", { exact: false })).toBeAttached();
+    assert.equal(await body.evaluate((element) => element.scrollTop), before);
+    await body.hover();
+    await page.mouse.wheel(0, 100_000);
+    await expect.poll(() => body.evaluate((element) => element.scrollHeight - element.scrollTop - element.clientHeight)).toBeLessThan(2);
+    await page.getByRole("button", { name: "Append reply", exact: true }).click();
+    await expect(page.getByText("New reply.", { exact: false })).toHaveCount(2);
+    await expect.poll(() => body.evaluate((element) => element.scrollHeight - element.scrollTop - element.clientHeight)).toBeLessThan(2);
+    await page.getByRole("button", { name: "Change conversation", exact: true }).click();
+    await expect(page.getByRole("button", { name: "Show less", exact: true })).toHaveCount(0);
+    await expect(page.getByRole("button", { name: "Read more", exact: true })).toBeAttached();
+  } finally {
+    await browser.close();
+    await stopProcess(vite);
+  }
+});
+
 test("conversation composer preserves typing and reacts to external state and pane resizing", {
   skip: !RUN_BROWSER_TEST,
   timeout: 60_000
@@ -168,6 +144,13 @@ test("conversation composer preserves typing and reacts to external state and pa
     const before = await input.evaluate((element) => element.clientHeight);
     await page.getByRole("button", { name: "Resize pane" }).evaluate((element) => element.click());
     await expect.poll(() => input.evaluate((element) => element.clientHeight)).toBeGreaterThan(before);
+    await page.getByRole("button", { name: "Toggle action feedback" }).evaluate((element) => element.click());
+    const feedback = page.getByText("Describe what you want to change.", { exact: true });
+    await expect(feedback).toBeVisible();
+    const sendBounds = await page.getByRole("button", { name: "Send", exact: true }).boundingBox();
+    assert.ok(sendBounds.height >= 48, "Compact panes retain a 48px action target on desktop");
+    assert.ok((await feedback.boundingBox()).y >= sendBounds.y + sendBounds.height, "Narrow action feedback follows the button");
+    await expect(input).toBeFocused();
     await input.dispatchEvent("keydown", { key: "Enter", isComposing: true });
     await expect(input).toHaveValue(draft);
     await input.press("Enter");

package/test/componentContracts.test.js

@@ -1,26 +1,13 @@
 import assert from "node:assert/strict";
 import test from "node:test";
-import { readFile } from "node:fs/promises";
-import path from "node:path";
-
-const packageRoot = new URL("../", import.meta.url);
-
-async function readPackageFile(relativePath) {
-  return readFile(path.join(packageRoot.pathname, relativePath), "utf8");
-}
-
-test("AssistantClientElement unwraps viewer refs before reading avatar fields", async () => {
-  const source = await readPackageFile("src/client/components/AssistantClientElement.vue");
-  assert.match(source, /normalizeObject\(unref\(props\.viewer\)\)/);
-});
-
-test("AssistantClientElement keeps its responsive scroll ancestors height-bounded", async () => {
-  const source = await readPackageFile("src/client/components/AssistantClientElement.vue");
-
-  assert.match(source, /<v-row class="assistant-layout h-100 flex-grow-1 flex-nowrap my-0">/u);
-  assert.match(source, /<v-col cols="12" md="8" class="assistant-main-col/u);
-  assert.match(source, /<v-col cols="12" md="4" class="assistant-side-col d-none d-md-flex/u);
-  assert.match(source, /class="d-md-none"/u);
-  assert.match(source, /\.assistant-main-col,\s*\.assistant-side-col,[\s\S]*height: 100%;[\s\S]*max-height: 100%;/u);
-  assert.match(source, /\.messages-panel \{[\s\S]*flex: 1 1 auto;[\s\S]*min-height: 0;[\s\S]*overflow: auto;/u);
+import { readFile, access } from "node:fs/promises";
+
+test("client entry points expose one conversation implementation and retain settings/API helpers", async () => {
+  const source = await readFile(new URL("../src/client/index.js", import.meta.url), "utf8");
+  assert.doesNotMatch(source, /AssistantClientElement/);
+  assert.match(source, /AssistantSettingsFormCard/);
+  assert.match(source, /createAssistantApi/);
+  await assert.rejects(access(new URL("../src/client/components/AssistantClientElement.vue", import.meta.url)));
+  const conversation = await readFile(new URL("../src/client/conversation/index.js", import.meta.url), "utf8");
+  assert.match(conversation, /AssistantConversationElement/);
 });