@jskit-ai/assistant-core 0.2.2 → 0.2.4

package/examples/conversation/package.json

@@ -8,14 +8,14 @@
     "build": "vite build"
   },
   "dependencies": {
-    "@jskit-ai/assistant-core": "0.2.2",
-    "@jskit-ai/http-runtime": "0.2.0",
-    "@jskit-ai/kernel": "0.2.0",
+    "@jskit-ai/assistant-core": "0.2.4",
+    "@jskit-ai/http-runtime": "0.2.1",
+    "@jskit-ai/kernel": "0.2.1",
     "@mdi/js": "^7.4.47",
     "vue": "^3.5.13",
     "vuetify": "^4.0.0",
-    "@jskit-ai/connectors-core": "0.2.0",
-    "@jskit-ai/connectors-catalog": "0.2.0"
+    "@jskit-ai/connectors-core": "0.2.1",
+    "@jskit-ai/connectors-catalog": "0.2.1"
   },
   "devDependencies": {
     "@vitejs/plugin-vue": "^6.0.7",

package/fixtures/responsive-assistant/ConversationFixture.vue

@@ -111,12 +111,12 @@ const adapter = reactive({
         discard(id) {
           if (id !== "temporary" || !previewCanTake.value) return;
           temporaryPresent.value = false;
-          if (previewDelivery.find(id)?.status === "failed") previewDelivery.cancel(id);
+          if (previewDelivery.find(id)?.status === "failed") previewDelivery.remove(id);
         },
         edit(id) {
           if (id !== "temporary" || !previewCanTake.value) return;
           temporaryEditing.value = true;
-          if (previewDelivery.find(id)?.status === "failed") previewDelivery.cancel(id);
+          if (previewDelivery.find(id)?.status === "failed") previewDelivery.remove(id);
         },
         update(id, text) {
           if (id === "temporary" && previewCanTake.value) temporaryWords.value = text;

package/fixtures/responsive-assistant/DeliveryFixture.vue

@@ -25,6 +25,16 @@ const delivery = createAssistantMessageDelivery({ deliver(payload) {
   pendingRequest = Promise.withResolvers();
   return pendingRequest.promise;
 } });
+// A stand-in for the application's server cancel: the recovery fixture answers
+// from its buttons, the others agree at once.
+let cancelAnswer;
+function cancelMessage(id) {
+  if (!delivery.cancel(id)) return false;
+  cancelAnswer = Promise.withResolvers();
+  cancelAnswer.promise.then(agreed => agreed ? delivery.remove(id) : delivery.cancelFailed(id));
+  if (!recoveryFixture) cancelAnswer.resolve(true);
+  return true;
+}
 function accept() {
   const payload = requests.value.at(-1);
   const at = new Date().toISOString();
@@ -56,8 +66,8 @@ const adapter = reactive({
   conversation: { cancellableDelivery: recoveryFixture, turns, visible: true, scrollKey: "delivery", welcomeMessage: "Start a conversation." },
   composer: { draft, canSend: true, submitOnEnter: true, queueWhileSending },
   actions: {
-    ...(recoveryFixture ? { cancel: id => delivery.remove(id) } : {}),
-    setDraft(value) { draft.value = value; }
+    setDraft(value) { draft.value = value; },
+    cancel: cancelMessage
   }
 });
 </script>
@@ -66,6 +76,9 @@ const adapter = reactive({
     <main class="fixture">
       <nav>
         <button v-if="acceptedFixture" @click="turns.unshift({ turnId: 'earlier', user: { messageId: 'accepted-old', text: 'Earlier accepted message', at: '2026-10-16T11:05:00.000Z' } })">Load accepted history</button>
+        <button v-if="recoveryFixture" @click="delivery.find('uncertain').checking = true">Start delivery check</button>
+        <button v-if="recoveryFixture" @click="cancelAnswer?.resolve(false)">Server unreachable</button>
+        <button v-if="recoveryFixture" @click="cancelAnswer?.resolve(true)">Server agrees to cancel</button>
         <button @click="pendingRequest.reject(new Error('Delivery unavailable.'))">Fail request</button>
         <button @click="accept">Accept request</button>
         <button @click="attachments.attachments.push({ attachmentId: 'new-file', fileName: 'next.txt' }); configuration = { tone: 'detailed' }">Prepare newer input</button>

package/locales/en.json

@@ -87,6 +87,8 @@
         "useSuggestion": "Use suggestion: {prompt}"
       },
       "delivery": {
+        "cancelling": "Cancelling…",
+        "cancelUnreachable": "Couldn't reach the server — Cancel again",
         "checkBeforeResend": "Check delivery before resending.",
         "checkPrevious": "Check the previous message's delivery before sending again.",
         "checking": "Checking…",
@@ -213,6 +215,8 @@
         "liveSettingsUnsupported": "This provider does not support live native settings.",
         "completedEnvelopesNeedStorage": "Completed envelopes require runtime-owned canonical storage.",
         "originalReadOnly": "This conversation uses its original read and subscription operations.",
+        "messageCancelUnsupported": "This conversation cannot cancel one message.",
+        "messageCancelled": "This message was cancelled. Send it again as a new message.",
         "authorizedSelectionRequired": "Use the conversation's authorized selection operation.",
         "eventDeliveryRetained": "This scoped conversation retains its original event delivery.",
         "engineChanged": "The selected native engine changed.",
@@ -371,8 +375,6 @@
       "conversation_receipt_unavailable": "The native receipt has no stored authored message.",
       "conversation_goal_unavailable": "The native goal is unavailable. Try reading its status again.",
       "assistant_provider_invalid_response": "Assistant provider returned an invalid response payload.",
-      "assistant_opencode_connection_changing": "OpenCode is changing a connection. Retry after the connection change finishes.",
-      "assistant_opencode_connection_in_use": "Close the other OpenCode conversations that use this connection, then retry this connection change. The saved connection has not changed.",
       "assistant_opencode_conversation_busy": "This conversation is still working.",
       "assistant_opencode_key_verification_failed": "OpenCode rejected the API-key verification request.",
       "assistant_opencode_turn_thread_mismatch": "The OpenCode predecessor history changed before handover generation.",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jskit-ai/assistant-core",
-  "version": "0.2.2",
+  "version": "0.2.4",
   "type": "module",
   "scripts": {
     "test": "node --test --test-concurrency=1"
@@ -48,8 +48,8 @@
     "@ai-sdk/perplexity": "^4.0.43",
     "@ai-sdk/togetherai": "^3.0.49",
     "@ai-sdk/xai": "^4.0.58",
-    "@jskit-ai/resource-core": "0.1.191",
-    "@jskit-ai/resource-crud-core": "0.1.191",
+    "@jskit-ai/resource-core": "0.1.192",
+    "@jskit-ai/resource-crud-core": "0.1.192",
     "@mdi/js": "^7.4.47",
     "@openrouter/ai-sdk-provider": "^3.0.0",
     "ai": "^7.0.101",
@@ -58,8 +58,8 @@
     "ws": "^8.20.1"
   },
   "peerDependencies": {
-    "@jskit-ai/http-runtime": "0.2.0",
-    "@jskit-ai/kernel": "0.2.0",
+    "@jskit-ai/http-runtime": "0.2.1",
+    "@jskit-ai/kernel": "0.2.1",
     "vue": "^3.5.13",
     "vuetify": "^4.0.0"
   },

package/src/client/conversation/AssistantConversationElement.vue

@@ -327,8 +327,15 @@ async function resend(id) {
   }
   catch { /* The delivery controller retains the error beside the failed message. */ }
 }
+// The application's cancel asks its server and removes the message only once
+// the server agrees. Without one, only a message the server already refused
+// (failed) is removed.
 function cancel(id) {
-  return props.adapter.actions?.cancel ? props.adapter.actions.cancel(id) : props.adapter.delivery?.cancel(id);
+  if (props.adapter.actions?.cancel) return props.adapter.actions.cancel(id);
+  const message = props.adapter.delivery?.find(id);
+  if (message?.status !== "failed") return false;
+  props.adapter.delivery.remove(id);
+  return true;
 }
 function edit(id) {
   if (props.adapter.actions?.edit) return props.adapter.actions.edit(id);

package/src/client/conversation/AssistantGoalControl.vue

@@ -70,9 +70,9 @@ async function setGoal() {
     </template>
     <v-card class="assistant-goal__details pa-3" max-width="360">
       <strong role="status">{{ label }}</strong>
-      <v-btn v-if="(running || (state.pauseBlocked && goal?.status === 'blocked')) && state.pause" size="small" :disabled="state.pending" @click="state.pause()">{{ state.action === 'pause' ? t('jskit.assistant.goal.pausing') : t('jskit.assistant.goal.pause') }}</v-btn>
+      <v-btn v-if="(running || (state.pauseBlocked && goal?.status === 'blocked')) && state.pause" size="small" :disabled="state.stopPending" @click="state.pause()">{{ state.action === 'pause' ? t('jskit.assistant.goal.pausing') : t('jskit.assistant.goal.pause') }}</v-btn>
       <v-btn v-if="['paused', 'blocked', 'usageLimited'].includes(goal?.status) && state.resume" size="small" :disabled="state.pending" @click="state.resume()">{{ state.action === 'resume' ? t('jskit.assistant.goal.resuming') : t('jskit.assistant.goal.resume') }}</v-btn>
-      <v-btn v-if="goal && goal.status !== 'complete' && state.cancel" color="error" size="small" variant="text" :disabled="state.pending" @click="state.cancel()">{{ state.action === 'cancel' ? t('jskit.assistant.goal.cancelling') : t('jskit.assistant.goal.cancel') }}</v-btn>
+      <v-btn v-if="goal && goal.status !== 'complete' && state.cancel" color="error" size="small" variant="text" :disabled="state.stopPending" @click="state.cancel()">{{ state.action === 'cancel' ? t('jskit.assistant.goal.cancelling') : t('jskit.assistant.goal.cancel') }}</v-btn>
       <p v-if="goal" class="my-2">{{ goal.objective }}</p>
       <p v-if="goal?.reason" class="text-body-small my-2">{{ goal.reason }}</p>
       <p v-if="elapsed" class="text-body-small my-2">{{ elapsedText }}</p>

package/src/client/conversation/AssistantTranscript.vue

@@ -65,10 +65,11 @@
       :class="{ 'assistant-transcript__body--settling': initialScrollPending }"
       tabindex="0"
       @keydown.capture="markKeyboardScrollIntent"
-      @pointerdown.self="markUserScrollIntent"
+      @pointerdown.self="markUserScrollIntent()"
       @scroll.passive="updateLatestFollowFromScroll"
-      @touchmove.passive="markUserScrollIntent"
-      @wheel.passive="markUserScrollIntent"
+      @touchstart.passive="rememberTouch"
+      @touchmove.passive="markTouchScrollIntent"
+      @wheel.passive="markUserScrollIntent({ upward: $event.deltaY < 0 })"
     >
       <div
         v-if="welcomeMessage"
@@ -179,12 +180,15 @@
             </div>
             <slot name="user-message-actions" :message="entry.message" :turn="entry.turn" />
             <div
-              v-if="entry.delivery || entry.turn.optimistic?.status === 'failed'"
+              v-if="entry.delivery || entry.turn.optimistic?.status === 'failed' || entry.turn.optimistic?.cancelling || entry.turn.optimistic?.cancelError"
               class="assistant-transcript__optimistic-failure"
             >
-              <span role="status">{{ entry.delivery ? entry.delivery.delivery.error || t('jskit.assistant.delivery.unconfirmedShort') : t('jskit.assistant.transcript.failed', { error: entry.turn.optimistic.error || t('jskit.assistant.delivery.notSent') }) }}</span>
+              <span role="status">{{ entry.turn.optimistic?.cancelling ? t('jskit.assistant.delivery.cancelling')
+                : entry.turn.optimistic?.cancelError ? entry.turn.optimistic.cancelError
+                  : entry.delivery ? entry.delivery.delivery.error || t('jskit.assistant.delivery.unconfirmedShort') : t('jskit.assistant.transcript.failed', { error: entry.turn.optimistic.error || t('jskit.assistant.delivery.notSent') }) }}</span>
               <div v-if="!entry.turn.preview" class="assistant-transcript__optimistic-actions">
                 <v-btn
+                  v-if="!entry.turn.optimistic?.cancelling && !entry.turn.optimistic?.cancelError && (entry.delivery || entry.turn.optimistic?.status === 'failed')"
                   class="assistant-transcript__delivery-action"
                   color="error"
                   size="x-small"
@@ -198,7 +202,7 @@
                   {{ entry.delivery?.delivery.checking ? t('jskit.assistant.delivery.checking') : t('jskit.assistant.delivery.retry') }}
                 </v-btn>
                 <v-btn
-                  v-if="!entry.delivery || cancellableDelivery"
+                  v-if="!entry.delivery || cancellableDelivery || entry.turn.optimistic?.cancelling || entry.turn.optimistic?.cancelError"
                   class="assistant-transcript__delivery-action"
                   size="x-small"
                   type="button"
@@ -208,7 +212,7 @@
                   {{ t("jskit.assistant.transcript.cancel") }}
                 </v-btn>
                 <v-btn
-                  v-if="!entry.delivery"
+                  v-if="!entry.delivery && entry.turn.optimistic?.status === 'failed' && !entry.turn.optimistic.cancelling && !entry.turn.optimistic.cancelError"
                   class="assistant-transcript__delivery-action"
                   size="x-small"
                   type="button"
@@ -328,6 +332,7 @@ import AssistantProgress from "./AssistantProgress.vue";
 import { parseNumberedQuestionPrompt } from "../../shared/conversation/numberedQuestionSugar.js";
 import { parseLongTextReviewBlocks } from "../../shared/conversation/longTextBlocks.js";
 import {
+  scrollDistanceFromBottom,
   scrollElementNearBottom
 } from "../../shared/conversation/scrollFollowState.js";
 import {
@@ -442,6 +447,9 @@ let retainedReaderScrollSnapshot = null;
 let loadMoreRequestVersion = 0;
 let pendingTailFollow = false;
 let previousScrollTop = 0;
+let previousScrollHeight = 0;
+let userScrollIntentUpward = false;
+let lastTouchY = null;
 const USER_SCROLL_INTENT_RESET_MS = 600;
 const LOAD_MORE_THRESHOLD_PX = 160;
 const KEYBOARD_SCROLL_KEYS = new Set([
@@ -454,6 +462,7 @@ const KEYBOARD_SCROLL_KEYS = new Set([
   "PageUp",
   "Spacebar"
 ]);
+const UPWARD_SCROLL_KEYS = new Set(["ArrowUp", "Home", "PageUp"]);
 const TIME_FORMAT = Object.freeze({
   year: "numeric",
   month: "short",
@@ -747,9 +756,10 @@ function resumePendingTailFollow() {
   }
 }
 
-function markUserScrollIntent() {
+function markUserScrollIntent({ upward = false } = {}) {
   retainedReaderScrollSnapshot = null;
   userScrollIntent.value = true;
+  userScrollIntentUpward = upward;
   clearLiveBottomScroll();
   clearScheduledScrolls();
   if (userScrollIntentTimer && typeof window !== "undefined" && typeof window.clearTimeout === "function") {
@@ -778,7 +788,20 @@ function markKeyboardScrollIntent(event = {}) {
   ) {
     return;
   }
-  markUserScrollIntent();
+  markUserScrollIntent({
+    upward: UPWARD_SCROLL_KEYS.has(event.key) || (event.shiftKey && [" ", "Spacebar"].includes(event.key))
+  });
+}
+
+function rememberTouch(event = {}) {
+  lastTouchY = event.touches?.[0]?.clientY ?? null;
+}
+
+function markTouchScrollIntent(event = {}) {
+  const touchY = event.touches?.[0]?.clientY ?? null;
+  // A finger moving down the screen scrolls the transcript up.
+  markUserScrollIntent({ upward: touchY !== null && lastTouchY !== null && touchY > lastTouchY });
+  lastTouchY = touchY;
 }
 
 function scrollToLatestMessageAfterLayout({
@@ -859,24 +882,38 @@ function updateLatestFollowFromScroll(event = {}) {
   const target = event?.currentTarget || bodyElement.value;
   if (retainedReaderScrollSnapshot?.restoring) {
     previousScrollTop = target?.scrollTop || 0;
+    previousScrollHeight = target?.scrollHeight || 0;
     return;
   }
   const scrollTop = target?.scrollTop || 0;
+  const scrollHeight = target?.scrollHeight || 0;
   const scrolledUp = scrollTop < previousScrollTop;
+  // Layout changes such as scroll anchoring move scrollTop together with the
+  // content height; moving up over unchanged content is the reader's own.
+  const readerMovedUp = scrolledUp && scrollHeight === previousScrollHeight;
   previousScrollTop = scrollTop;
+  previousScrollHeight = scrollHeight;
   // Keep following the reader while the request is pending, before rows prepend.
   if (loadMoreScrollSnapshot && !loadMoreScrollSnapshot.completed) {
     loadMoreScrollSnapshot.scrollTop = scrollTop;
     loadMoreScrollSnapshot.anchor = visibleHistoryAnchor(target);
     loadMoreScrollSnapshot.scrollHeight = target.scrollHeight;
   }
-  const shouldFollow = scrollElementNearBottom(target);
-  if (!shouldFollow && !userScrollIntent.value && followingLatest.value) {
+  // The reader's own upward scrolling leaves the latest message from its first
+  // frame, even within the follow threshold.
+  const userScrollsUp = userScrollIntent.value && userScrollIntentUpward;
+  const shouldFollow = scrollElementNearBottom(target) &&
+    !(userScrollsUp && scrollDistanceFromBottom(target) > 1);
+  if (!shouldFollow && !userScrollIntent.value && !readerMovedUp && followingLatest.value) {
     return;
   }
   followingLatest.value = shouldFollow;
   if (shouldFollow) {
-    clearUserScrollIntent();
+    // A scroll event still at the end, queued before upward input, must not
+    // end that input's intent.
+    if (!userScrollsUp) {
+      clearUserScrollIntent();
+    }
     resumePendingTailFollow();
     return;
   }

package/src/client/conversation/messageDelivery.js

@@ -100,7 +100,8 @@ function createAssistantMessageDelivery({ deliver: defaultDeliver } = {}) {
     } : null;
     return {
       optimistic: { error: message.error, id: message.id, status: message.status,
-        ...(message.status === "pending" && message.waiting ? { waiting: message.waiting } : {}) },
+        ...(message.status === "pending" && message.waiting ? { waiting: message.waiting } : {}),
+        ...(message.cancelling ? { cancelling: true } : {}), ...(message.cancelError ? { cancelError: message.cancelError } : {}) },
       turnId: message.id,
       [role]: authored,
       ...(status ? { system: role === "system" ? { ...authored, ...status, text: `${authored.text}\n\n${status.text}` } : status } : {})
@@ -117,7 +118,7 @@ function createAssistantMessageDelivery({ deliver: defaultDeliver } = {}) {
     queue = false
   } = {}) {
     if ((state.sending && !queue) || pendingSends.has(messageId) || find(messageId)?.status === "uncertain" ||
-        (!messageText(payload?.message) && !payload?.displayAttachments?.length)) return false;
+        find(messageId)?.cancelling || (!messageText(payload?.message) && !payload?.displayAttachments?.length)) return false;
     if (typeof deliver !== "function") throw new TypeError("Message delivery requires a deliver function.");
     const snapshot = JSON.parse(JSON.stringify(payload));
     const previous = find(messageId);
@@ -147,6 +148,8 @@ function createAssistantMessageDelivery({ deliver: defaultDeliver } = {}) {
     try {
       if (predecessor) await predecessor;
       if (!current()) return false;
+      // A queued message cancelled while it waited is never delivered.
+      if (find(messageId)?.cancelling) return false;
       if (uncertainOnError && state.messages.some(entry => entry.id !== messageId && entry.status === "uncertain" && !knownUncertain.has(entry.id))) {
         fail(messageId, t("jskit.assistant.delivery.checkPrevious"));
         return false;
@@ -240,15 +243,29 @@ function createAssistantMessageDelivery({ deliver: defaultDeliver } = {}) {
     return true;
   }
 
+  // Cancel of a pending, uncertain or failed message waits for the server: the
+  // message stays, shown as cancelling, until the caller removes it on the
+  // server's agreement or reports that the server could not be reached.
   function cancel(messageId) {
-    if (find(messageId)?.status !== "failed") return false;
-    remove(messageId);
+    const message = find(messageId);
+    if (!message || message.status === "accepted" || message.cancelling) return false;
+    message.cancelling = true;
+    message.cancelError = "";
     return true;
   }
 
+  function cancelFailed(messageId, error = "") {
+    const message = find(messageId);
+    if (!message) return;
+    message.cancelling = false;
+    message.cancelError = String(error || t("jskit.assistant.delivery.cancelUnreachable")).trim();
+  }
+
+  // Only a message that never reached the conversation returns to the draft.
   function edit(messageId, draft = "") {
     const message = find(messageId);
-    if (!message || !cancel(messageId)) return null;
+    if (message?.status !== "failed" || message.cancelling) return null;
+    remove(messageId);
     return draftWithRestoredMessage(message.text, draft);
   }
 
@@ -269,7 +286,7 @@ function createAssistantMessageDelivery({ deliver: defaultDeliver } = {}) {
     state.sending = false;
   }
 
-  return { accept, cancel, edit, find, reconcile, remove, resend, reset, restoreUncertain, rejectUnsent, send, state, turns, wait };
+  return { accept, cancel, cancelFailed, edit, find, reconcile, remove, resend, reset, restoreUncertain, rejectUnsent, send, state, turns, wait };
 }
 
 // The composer text after a failed or cancelled message returns to it: the

package/src/client/lib/assistantApi.js

@@ -133,6 +133,11 @@ function createAssistantApi({ request, requestStream, resolveBasePath, resolveSu
       return requestConversation(conversationId, `/deliveries/${encodedMessageId}/inspect`, { method: "POST", signal });
     },
 
+    cancelConversationDelivery(conversationId, messageId, { signal } = {}) {
+      const encodedMessageId = encodeURIComponent(String(messageId || "").trim());
+      return requestConversation(conversationId, `/deliveries/${encodedMessageId}/cancel`, { method: "POST", signal });
+    },
+
     readConversationGoal(conversationId, { signal } = {}) {
       return requestConversation(conversationId, "/goal", { method: "GET", signal });
     },