@jskit-ai/assistant-core 0.2.24 → 0.2.26

package/CHANGELOG.md

@@ -2,7 +2,12 @@
 
 ## Unreleased
 
-- The avatar's Show and Minimise buttons set no fixed height: they are 40dp icon buttons with material-web's 48dp touch target, so `jskit check m3` passes on `AssistantConversationElement`.
+- The OpenAI SDK loads with an OpenAI-compatible client's first completion instead of with the server, so a boot of an app with the assistant loads 154 fewer modules (0.13 s on their own).
+- A subscriber hears a streamed delta (an in-progress message) on an authorization under a second old instead of authorizing again for each one: every delta used to wait for one `authorize` call per subscriber before the stream continued (one SELECT each in `@jskit-ai/assistant-runtime`), so a 200-delta reply to one open page cost about 200 reads and now costs as many as a 10-delta one. Every other event (admission, phase, saved message, settlement) still authorizes again, and a revoked subscriber stops hearing the turn within a second.
+- The conversation's remaining boxes are Material 3 tonal containers instead of outlines, visual only: queued and sent attachments and the questions are `surface-container-high`, code blocks and inline code `surface-container-highest`, tables and details `surface-container-low` (a table keeps `outline-variant` row dividers), question numbers `secondary-container` badges, and the model menu a `surface-container` surface at elevation level 2 with `outline-variant` dividers. The composer stays Material 3's outlined text field, the only outline left.
+- `AssistantSettingsFormCard` takes a `formId`: its form gets that id and the card draws no Save button of its own, so the page's app bar can carry Save as a submit button for the form (`type="submit" form="<formId>"`), as a Material 3 settings pane does. Without one, the card keeps its Save; a person who may not save still sees the read-only note.
+- Material 3 containers in the conversation, visual only: the transcript area is no longer outlined (its bubbles are the only containers, and the welcome bubble is a tonal fill without an outline), the composer is Material 3's outlined text field (4dp corners, the `outline` role, a 2dp primary outline on focus, 16dp side padding) with Send and the other actions 12dp from it (8dp when compact), and `AssistantSettingsFormCard` adds no heading or divider inside the settings pane that titles it: its subtitle is the card's first line and its title names the section for assistive technology.
+- The avatar's Show and Minimise buttons set no fixed size: they are 40dp icon buttons with material-web's 48dp touch target, so `jskit check m3` passes on `AssistantConversationElement`. The collapsed Show button is 40dp wide like Minimise, no longer 44dp.
 - The goal menu closes when Cancel succeeds, as it does after Start; Pause and Resume keep it open.
 - `AssistantConversationElement` has an `avatar-thumbnail` slot, with the `{ size, height }` scope of the other avatar slots: while the avatar is hidden, the **Show avatar** button draws its content instead of the anonymous account icon, such as a still miniature of the avatar, clipped to the button's round 32-pixel disc. The button keeps its label, title and 44-pixel target, and shows the icon as before without the slot.
 - A delivered Codex turn is held as not yet started only until Codex reports it: a `turn/started` that arrives before the `turn/start` answer counts, and a thread read listing exactly that turn as completed or failed settles a turn whose notifications were missed, so its answer is no longer kept waiting for a notification that never comes.

package/examples/conversation/package.json

@@ -8,14 +8,14 @@
     "build": "vite build"
   },
   "dependencies": {
-    "@jskit-ai/assistant-core": "0.2.24",
-    "@jskit-ai/http-runtime": "0.2.10",
-    "@jskit-ai/kernel": "0.2.10",
-    "@jskit-ai/material-web": "0.1.2",
+    "@jskit-ai/assistant-core": "0.2.26",
+    "@jskit-ai/http-runtime": "0.2.12",
+    "@jskit-ai/kernel": "0.2.12",
+    "@jskit-ai/material-web": "0.1.3",
     "vue": "^3.5.13",
     "vuetify": "^4.0.0",
-    "@jskit-ai/connectors-core": "0.2.11",
-    "@jskit-ai/connectors-catalog": "0.2.11"
+    "@jskit-ai/connectors-core": "0.2.13",
+    "@jskit-ai/connectors-catalog": "0.2.13"
   },
   "devDependencies": {
     "@vitejs/plugin-vue": "^6.0.7",

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "@jskit-ai/assistant-core",
-  "version": "0.2.24",
+  "version": "0.2.26",
   "type": "module",
   "scripts": {
-    "test": "node --test --test-concurrency=1"
+    "test": "jskit test"
   },
   "exports": {
     "./client": "./src/client/index.js",
@@ -51,9 +51,9 @@
     "@ai-sdk/perplexity": "^4.0.43",
     "@ai-sdk/togetherai": "^3.0.49",
     "@ai-sdk/xai": "^4.0.58",
-    "@jskit-ai/agent": "0.1.1",
-    "@jskit-ai/resource-core": "0.1.201",
-    "@jskit-ai/resource-crud-core": "0.1.201",
+    "@jskit-ai/agent": "0.1.2",
+    "@jskit-ai/resource-core": "0.1.203",
+    "@jskit-ai/resource-crud-core": "0.1.203",
     "@openrouter/ai-sdk-provider": "^3.0.0",
     "ai": "^7.0.152",
     "json-rest-schema": "^1.0.17",
@@ -61,8 +61,8 @@
     "ws": "^8.20.1"
   },
   "peerDependencies": {
-    "@jskit-ai/http-runtime": "0.2.10",
-    "@jskit-ai/kernel": "0.2.10",
+    "@jskit-ai/http-runtime": "0.2.12",
+    "@jskit-ai/kernel": "0.2.12",
     "vue": "^3.5.13",
     "vuetify": "^4.3.0"
   },
@@ -220,6 +220,6 @@
     }
   },
   "devDependencies": {
-    "@jskit-ai/material-web": "0.1.2"
+    "@jskit-ai/material-web": "0.1.3"
   }
 }

package/src/client/components/AssistantSettingsFormCard.vue

@@ -1,12 +1,10 @@
 <template>
-  <section :class="props.rootClass">
+  <!-- The settings pane around it carries the page title, so the card adds no heading of its own: the title names the
+       section for assistive technology and the subtitle says what the settings apply to. -->
+  <section :class="props.rootClass" :aria-label="props.title">
     <v-card>
-      <v-card-item>
-        <v-card-title class="text-title-large">{{ props.title }}</v-card-title>
-        <v-card-subtitle>{{ props.subtitle }}</v-card-subtitle>
-      </v-card-item>
-      <v-divider />
-      <v-card-text class="pt-4">
+      <v-card-text>
+        <p class="text-body-medium on-surface-variant mb-4">{{ props.subtitle }}</p>
         <template v-if="props.showFormSkeleton">
           <v-skeleton-loader type="text@2, list-item-two-line@4, button" />
         </template>
@@ -20,10 +18,12 @@
         </p>
 
         <template v-else>
-          <v-form @submit.prevent="props.addEdit.submit" novalidate>
+          <!-- With a formId, the page's app bar carries Save (a submit button for this form), as a settings pane does;
+               the card then shows only the read-only note. -->
+          <v-form :id="props.formId || undefined" @submit.prevent="props.addEdit.submit" novalidate>
             <v-progress-linear v-if="props.addEdit.isRefetching" indeterminate class="mb-4" />
             <slot />
-            <div class="d-flex align-center justify-end ga-3 mt-2">
+            <div v-if="!props.formId || !props.addEdit.canSave" class="d-flex align-center justify-end ga-3 mt-2">
               <v-btn
                 v-if="props.addEdit.canSave"
                 type="submit"
@@ -74,6 +74,11 @@ const props = defineProps({
   showFormSkeleton: {
     type: Boolean,
     default: false
+  },
+  // The form's id, when the page's app bar carries its Save button (type="submit" form="<formId>").
+  formId: {
+    type: String,
+    default: ""
   }
 });
 </script>

package/src/client/conversation/AssistantAttachmentQueue.vue

@@ -307,10 +307,9 @@ onBeforeUnmount(() => {
 </script>
 
 <style scoped>
+/* A Material 3 tonal container above the composer: a surface-container-high fill, no outline. */
 .assistant-attachment-queue {
-  background: rgba(var(--v-theme-on-surface), 0.035);
-  border: 1px solid rgba(var(--v-theme-outline), 0.2);
-  border-bottom: 0;
+  background: rgb(var(--v-theme-surface-container-high));
   border-radius: 14px 14px 0 0;
   color: rgb(var(--v-theme-on-surface));
   display: grid;
@@ -332,7 +331,6 @@ onBeforeUnmount(() => {
 }
 
 .assistant-attachment-queue--standalone {
-  border-bottom: 1px solid rgba(var(--v-theme-outline), 0.2);
   border-radius: 10px;
 }
 

package/src/client/conversation/AssistantConversationElement.vue

@@ -8,7 +8,7 @@
         <slot name="avatar-control" :size="avatarSize" :height="avatarHeight" />
         <v-btn
           icon="$accountCircle" size="small"
-          variant="text" :width="44" :min-width="44"
+          variant="text"
           class="assistant-conversation__avatar-size"
           :aria-label="t('jskit.assistant.chat.showAvatar')" :title="t('jskit.assistant.chat.showAvatar')"
           :aria-expanded="avatarSize !== 'hidden'" @click="toggleAvatar"
@@ -26,7 +26,7 @@
           <slot name="avatar-tools" :size="avatarSize" :height="avatarHeight" />
           <v-btn
             icon="$minus" size="small" variant="text" color="primary"
-            :width="40" :min-width="40" class="assistant-conversation__avatar-size"
+            class="assistant-conversation__avatar-size"
             :aria-label="t('jskit.assistant.chat.minimiseAvatar')" :title="t('jskit.assistant.chat.minimiseAvatar')" :aria-expanded="true"
             @click="toggleAvatar"
           >

package/src/client/conversation/AssistantMessageAttachments.vue

@@ -70,10 +70,10 @@ function attachmentKey(attachment, index) {
   width: min(19rem, 100%);
 }
 
+/* Each attachment is a Material 3 tonal container: a surface-container-high fill, no outline. */
 .assistant-conversation-attachments__item {
   align-items: center;
-  background: rgba(var(--v-theme-surface), 0.82);
-  border: 1px solid rgba(var(--v-theme-outline), 0.2);
+  background: rgb(var(--v-theme-surface-container-high));
   border-radius: 10px;
   color: rgb(var(--v-theme-on-surface));
   min-height: 2.8rem;

package/src/client/conversation/AssistantModelControl.vue

@@ -20,11 +20,12 @@
       />
     </template>
 
+    <!-- A Material 3 menu surface: surface-container at elevation level 2, no outline. -->
     <v-sheet
       :aria-label="t('jskit.assistant.model.selector')"
-      border
       class="assistant-model-control"
-      :elevation="3"
+      color="surface-container"
+      :elevation="2"
       rounded="xl"
     >
       <header class="assistant-model-control__header">
@@ -235,7 +236,7 @@ function selectVariant(value) { if (!props.changesDisabled && !props.saving) emi
 
 .assistant-model-control__header {
   align-items: center;
-  border-bottom: 1px solid rgba(var(--v-theme-outline), 0.12);
+  border-bottom: 1px solid rgb(var(--v-theme-outline-variant));
   display: flex;
   gap: 0.65rem;
   padding: 0.1rem 0.1rem 0.7rem;
@@ -311,7 +312,7 @@ function selectVariant(value) { if (!props.changesDisabled && !props.saving) emi
 
 .assistant-model-control__actions {
   align-items: center;
-  border-top: 1px solid rgba(var(--v-theme-outline), 0.12);
+  border-top: 1px solid rgb(var(--v-theme-outline-variant));
   display: grid;
   gap: 0.4rem;
   grid-template-columns: auto 1fr auto;

package/src/client/conversation/AssistantPromptInput.vue

@@ -261,12 +261,13 @@ defineExpose({ inputElement: textareaRef, focus: focusTextarea, preserveHeightFo
   width: 100%;
 }
 
+/* Material 3's outlined text field: 4dp corners, a 1dp outline that becomes a 2dp primary one on focus (drawn inset, so
+   nothing moves), 16dp side padding, and the label in the outline. */
 .assistant-prompt-input__field {
   background: rgb(var(--v-theme-surface));
-  border: 1px solid rgba(var(--v-theme-on-surface), 0.34);
-  border-radius: 18px;
+  border: 1px solid rgb(var(--v-theme-outline));
+  border-radius: 4px;
   box-sizing: border-box;
-  box-shadow: inset 0 0 0 1px rgba(var(--v-theme-on-surface), 0.08);
   display: grid;
   max-width: 100%;
   min-width: 0;
@@ -274,29 +275,33 @@ defineExpose({ inputElement: textareaRef, focus: focusTextarea, preserveHeightFo
   transition: border-color 120ms ease, box-shadow 120ms ease;
 }
 
+.assistant-prompt-input__field:not(.assistant-prompt-input__field--disabled):hover {
+  border-color: rgb(var(--v-theme-on-surface));
+}
+
 .assistant-prompt-input__field:not(.assistant-prompt-input__field--disabled):focus-within {
   border-color: rgb(var(--v-theme-primary));
-  box-shadow:
-    0 0 0 2px rgba(var(--v-theme-primary), 0.28),
-    inset 0 0 0 1px rgba(var(--v-theme-primary), 0.2);
+  box-shadow: inset 0 0 0 1px rgb(var(--v-theme-primary));
 }
 
 .assistant-prompt-input__field--disabled {
-  background: rgba(var(--v-theme-on-surface), 0.04);
-  border-color: rgba(var(--v-theme-on-surface), 0.16);
-  box-shadow: none;
+  border-color: rgba(var(--v-theme-on-surface), 0.12);
+}
+
+.assistant-prompt-input__field:not(.assistant-prompt-input__field--disabled):focus-within .assistant-prompt-input__label {
+  color: rgb(var(--v-theme-primary));
 }
 
 .assistant-prompt-input__label {
   align-self: start;
   background: rgb(var(--v-theme-surface));
-  color: rgba(var(--v-theme-on-surface), 0.82);
-  font-size: 0.78rem;
-  line-height: 1.1;
-  margin: -0.5rem 0 0 0.9rem;
-  max-width: calc(100% - 1.8rem);
+  color: rgb(var(--v-theme-on-surface-variant));
+  font-size: 0.75rem;
+  line-height: 1rem;
+  margin: -0.5rem 0 0 12px;
+  max-width: calc(100% - 24px);
   overflow: hidden;
-  padding-inline: 0.24rem;
+  padding-inline: 4px;
   text-overflow: ellipsis;
   white-space: nowrap;
   width: fit-content;
@@ -349,19 +354,20 @@ defineExpose({ inputElement: textareaRef, focus: focusTextarea, preserveHeightFo
   opacity: 1;
 }
 
+/* Send and the other actions keep 12dp from the outline (8dp in the compact composer). */
 .assistant-prompt-input__footer {
   min-width: 0;
-  padding: 0 0.55rem 0.55rem;
+  padding: 0 12px 12px;
 }
 
 .assistant-prompt-input--compact .assistant-prompt-input__input {
   max-height: min(8rem, 20dvh);
   min-height: 2.5rem;
-  padding: 0.4rem 0.65rem 0.15rem;
+  padding: 0.4rem 12px 0.15rem;
 }
 
 .assistant-prompt-input--compact .assistant-prompt-input__footer {
-  padding: 0 0.3rem 0.25rem;
+  padding: 0 8px 8px;
 }
 
 .assistant-prompt-input__details {

package/src/client/conversation/AssistantTranscript.css

@@ -1,7 +1,6 @@
 .assistant-transcript__plain-user { white-space: pre-wrap; margin: 0; }
+/* The transcript is the page's own area, not a container: its bubbles are the only containers in it. */
 .assistant-transcript {
-  border: 1px solid rgba(var(--v-theme-outline), 0.24);
-  border-radius: 8px;
   display: grid;
   gap: 0.35rem;
   grid-template-rows: minmax(0, 1fr);
@@ -87,7 +86,6 @@
 
 .assistant-transcript__welcome {
   background: rgba(var(--v-theme-primary), 0.08);
-  border: 1px solid rgba(var(--v-theme-primary), 0.18);
   border-radius: 16px;
   color: rgb(var(--v-theme-on-surface));
   display: grid;
@@ -239,10 +237,6 @@
   padding: 0;
 }
 
-.assistant-transcript--task {
-  border-color: rgba(126, 87, 194, 0.32);
-}
-
 .assistant-transcript--task .assistant-transcript__avatar--assistant {
   background: #7e57c2;
 }
@@ -416,10 +410,9 @@
 .assistant-transcript__message--user :deep(.studio-long-text-review__table th > code),
 .assistant-transcript__message--user :deep(.studio-long-text-review__table td > code),
 .assistant-transcript__message--user :deep(.studio-long-text-review__details-summary code) {
-  background: rgba(var(--v-theme-primary), 0.07);
-  border: 1px solid rgba(var(--v-theme-primary), 0.14);
+  background: rgb(var(--v-theme-surface-container-highest));
   border-radius: 3px;
-  color: rgba(var(--v-theme-on-surface), 0.9);
+  color: rgb(var(--v-theme-on-surface));
   font-family: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", monospace;
   font-size: 0.9em;
   padding: 0.02rem 0.2rem;
@@ -436,10 +429,10 @@
   padding: 0;
 }
 
+/* Questions are tonal containers (surface-container-high), their numbers secondary-container badges: no outlines. */
 .assistant-transcript__question {
   align-items: start;
-  background: rgba(var(--v-theme-surface), 0.62);
-  border: 1px solid rgba(var(--v-theme-outline), 0.2);
+  background: rgb(var(--v-theme-surface-container-high));
   border-radius: 8px;
   box-sizing: border-box;
   display: grid;
@@ -452,10 +445,9 @@
 
 .assistant-transcript__question-number {
   align-items: center;
-  background: rgba(var(--v-theme-primary), 0.1);
-  border: 1px solid rgba(var(--v-theme-primary), 0.2);
+  background: rgb(var(--v-theme-secondary-container));
   border-radius: 999px;
-  color: rgb(var(--v-theme-primary));
+  color: rgb(var(--v-theme-on-secondary-container));
   display: inline-flex;
   font-size: 0.72rem;
   font-weight: 760;

package/src/client/conversation/LongTextInlineParts.vue

@@ -44,10 +44,9 @@ function handleLinkClick(event, part = {}) {
 
 <style scoped>
 code {
-  background: rgba(var(--v-theme-primary), 0.07);
-  border: 1px solid rgba(var(--v-theme-primary), 0.14);
+  background: rgb(var(--v-theme-surface-container-highest));
   border-radius: 3px;
-  color: rgba(var(--v-theme-on-surface), 0.9);
+  color: rgb(var(--v-theme-on-surface));
   font-family: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", monospace;
   font-size: 0.9em;
   overflow-wrap: anywhere;

package/src/client/conversation/LongTextPreviewBlocks.vue

@@ -240,9 +240,10 @@ h5.studio-long-text-review__heading {
   font-size: 0.8rem;
 }
 
+/* Code, tables and details are Material 3 tonal containers (surface-container tones), not outlined boxes; a
+   table keeps outline-variant dividers between its rows. */
 .studio-long-text-review__code {
-  background: rgba(var(--v-theme-surface-variant), 0.58);
-  border: 1px solid rgba(var(--v-border-color), 0.26);
+  background: rgb(var(--v-theme-surface-container-highest));
   border-radius: 8px;
   font-family: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", monospace;
   font-size: 0.82rem;
@@ -256,7 +257,7 @@ h5.studio-long-text-review__heading {
 }
 
 .studio-long-text-review__table-wrap {
-  border: 1px solid rgba(var(--v-border-color), 0.28);
+  background: rgb(var(--v-theme-surface-container-low));
   border-radius: 8px;
   inline-size: fit-content;
   margin-block: 0.35rem;
@@ -282,7 +283,7 @@ h5.studio-long-text-review__heading {
 
 .studio-long-text-review__table th,
 .studio-long-text-review__table td {
-  border-bottom: 1px solid rgba(var(--v-border-color), 0.22);
+  border-bottom: 1px solid rgb(var(--v-theme-outline-variant));
   max-inline-size: 28rem;
   padding: 0.55rem 0.75rem;
   text-align: left;
@@ -290,7 +291,7 @@ h5.studio-long-text-review__heading {
 }
 
 .studio-long-text-review__table th {
-  background: rgba(var(--v-theme-surface-variant), 0.48);
+  background: rgb(var(--v-theme-surface-container-high));
   color: rgb(var(--v-theme-on-surface));
   font-weight: 760;
   position: sticky;
@@ -320,7 +321,7 @@ h5.studio-long-text-review__heading {
 }
 
 .studio-long-text-review__details {
-  border: 1px solid rgba(var(--v-border-color), 0.34);
+  background: rgb(var(--v-theme-surface-container-low));
   border-radius: 8px;
   display: block;
   min-width: 0;

package/src/server/conversation/codexProviderOwner.js

@@ -550,7 +550,12 @@ export function createCodexAppServerProviderOwner({
     assertOpen();
     if (!record.observationStop || record.observationStop.error !== error) {
       reportRecoveryEvent(record, "lost", error);
-      const stop = { error, promise: invalidation.suspendUnobservedProvider(record, error) };
+      // A shared stop of this native runtime gives each of its peers the failure that started it, and records their
+      // barriers and completion itself. A peer that then loses its own connection to the stopped process joins that
+      // stop instead of stopping the runtime again, which would reopen its stopped barrier while the first finishes.
+      const runtimeKey = codexAppServerOwnedRuntimeKey(record.providerKey, record.providerOptions);
+      const shared = runtimePeers(runtimeKey).find(peer => peer !== record && peer.observationStop?.error === error);
+      const stop = { error, promise: shared?.observationStop.promise || invalidation.suspendUnobservedProvider(record, error) };
       record.observationStop = stop;
       const tracked = stop.promise.catch(failure => {
         reportRecoveryEvent(record, "stopFailed", failure);

package/src/server/conversation/conversationEvents.js

@@ -4,6 +4,9 @@ import { submittedMessage } from "./conversationReads.js";
 
 /** @typedef {import("./conversationEntries.js").ConversationEntry} ConversationEntry */
 
+// How long a subscriber's authorization covers the streamed deltas that follow it.
+const STREAMED_DELTA_AUTHORIZATION_MS = 1000;
+
 /**
  * Runs one conversation entry's operations in order: each waits for the one before it.
  * @param {ConversationEntry} entry
@@ -36,16 +39,40 @@ function createConversationEvents({ authorize, isClosed, storage, streams, compl
    * @param {Set<string>} [grant] The operations this call already authorized.
    */
   async function access(context, id, operation, entry, grant) {
-    if (isClosed() || entry?.disposed) throw failure("This conversation handle is closed.", "conversation_handle_closed", 409, { messageCode: "assistant.conversation.handleClosed" });
+    assertOpen(entry);
     if (!grant?.has(operation)) {
       if (!await authorize({ context, conversationId: id, operation })) {
         throw failure("This conversation is not available to this identity.", "conversation_forbidden", 403);
       }
       grant?.add(operation);
     }
+    assertOpen(entry);
+  }
+
+  /** @param {ConversationEntry} [entry] */
+  function assertOpen(entry) {
     if (isClosed() || entry?.disposed) throw failure("This conversation handle is closed.", "conversation_handle_closed", 409, { messageCode: "assistant.conversation.handleClosed" });
   }
 
+  /**
+   * A subscriber hears an event once it is authorized again. A streamed delta (an in-progress
+   * message) uses the subscriber's last authorization while it is under a second old: a reply
+   * streams hundreds of deltas, each authorization is a read the stream waits for, and a
+   * revoked subscriber still stops hearing the turn within a second. Every other event (an
+   * admission, a phase, a saved message, a settlement) authorizes again.
+   * @param {ConversationEntry} entry
+   * @param {{ context: object, authorizedAt?: number }} subscription
+   * @param {boolean} streamed
+   */
+  async function admitSubscriber(entry, subscription, streamed) {
+    if (streamed && Date.now() - subscription.authorizedAt < STREAMED_DELTA_AUTHORIZATION_MS) {
+      assertOpen(entry);
+      return;
+    }
+    await access(subscription.context, entry.id, "subscribe", entry);
+    subscription.authorizedAt = Date.now();
+  }
+
   /**
    * @param {ConversationEntry} entry
    * @param {object} event
@@ -80,8 +107,9 @@ function createConversationEvents({ authorize, isClosed, storage, streams, compl
           .some(message => message.messageId === payload.messageId && message.completedEnvelope === true && message.origin === "application");
       if (marked) payload.completedEnvelope = true;
     }
+    const streamed = payload.type === "message" && payload.status === "inProgress";
     await Promise.all([...entry.listeners].map(async subscription => {
-      try { await access(subscription.context, entry.id, "subscribe", entry); }
+      try { await admitSubscriber(entry, subscription, streamed); }
       catch { entry.listeners.delete(subscription); return; }
       if (isCurrent && !isCurrent()) return;
       // Presentation failures cannot interrupt persistence or provider work.

package/src/server/conversation/conversationHandles.js

@@ -212,7 +212,7 @@ function createConversationHandles({ entries, storage, defaultHost, events, read
         await events.access(context, id, "subscribe", entry);
         if (entry.conversation?.native?.scoped) throw failure("This scoped conversation retains its original event delivery.", "conversation_event_delivery_retained", 409, { messageCode: "assistant.conversation.eventDeliveryRetained" });
         if (typeof listener !== "function") throw new TypeError("A conversation listener is required.");
-        const subscription = { context, listener };
+        const subscription = { context, listener, authorizedAt: Date.now() };
         entry.listeners.add(subscription);
         return () => entry.listeners.delete(subscription);
       },

package/src/server/lib/providers/openAiCompatibleClient.js

@@ -1,4 +1,3 @@
-import OpenAI from "openai";
 import { createOpenAI } from "@ai-sdk/openai";
 import { chatModel } from "@jskit-ai/agent/server";
 import { normalizeText } from "@jskit-ai/kernel/shared/support/normalize";
@@ -37,11 +36,16 @@ function createOpenAiCompatibleClient({
   const normalizedBaseUrl = normalizeOptionalHttpUrl(baseUrl, {
     context: `assistant ${normalizedProvider} baseUrl`
   });
-  const client = new OpenAI({
-    apiKey: normalizedApiKey,
-    ...(normalizedBaseUrl ? { baseURL: normalizedBaseUrl } : {}),
-    timeout: normalizeTimeoutMs(timeoutMs)
-  });
+  // The OpenAI SDK (150 modules) loads with the first completion, not with every server that could ask for one.
+  let clientPromise = null;
+  const chatCompletions = async () => {
+    clientPromise ??= import("openai").then(({ default: OpenAI }) => new OpenAI({
+      apiKey: normalizedApiKey,
+      ...(normalizedBaseUrl ? { baseURL: normalizedBaseUrl } : {}),
+      timeout: normalizeTimeoutMs(timeoutMs)
+    }));
+    return (await clientPromise).chat.completions;
+  };
 
   const baseURL = normalizedBaseUrl || undefined;
 
@@ -54,11 +58,11 @@ function createOpenAiCompatibleClient({
       stream: false
     };
 
-    return client.chat.completions.create(requestPayload, signal ? { signal } : undefined);
+    return (await chatCompletions()).create(requestPayload, signal ? { signal } : undefined);
   }
 
   async function createChatCompletionStream({ messages = [], tools = [], signal, temperature = 0.2 } = {}) {
-    return client.chat.completions.create(
+    return (await chatCompletions()).create(
       {
         model: normalizedModel,
         messages,