dsh-realtime-audio-ws 0.2.6 → 0.2.7

package/lib/client/bundle.js

@@ -402,8 +402,14 @@ window.__ModuleLoader__.load({ id: "dsh-realtime-audio-ws",
         const lines = [`<p data-dsh-strip-voice>${escapeHtml(summariseVoice(reply, state.audio))}</p>`];
         if (reply !== null)
             lines.push(`<p data-dsh-strip-route>${escapeHtml(summariseRoute(reply))}</p>`);
-        if (state.notice !== '')
-            lines.push(`<p data-dsh-strip-notice>${escapeHtml(state.notice)}</p>`);
+        if (state.notice !== '') {
+            const link = state.noticeLink ?? '';
+            const anchor = link === ''
+                ? ''
+                : ` <a data-dsh-strip-link href="${escapeHtml(link)}" target="_blank"`
+                    + ' rel="noreferrer noopener">open ↗</a>';
+            lines.push(`<p data-dsh-strip-notice>${escapeHtml(state.notice)}${anchor}</p>`);
+        }
         lines.push(`<p data-dsh-strip-buttons>${buttons(state.audio)}</p>`);
         // Restart-bound settings are omitted rather than shown read-only: the gate says no control at all, and a
         // row that cannot be changed is a row a reader will try to change.
@@ -521,8 +527,10 @@ window.__ModuleLoader__.load({ id: "dsh-realtime-audio-ws",
         let reply = null;
         const notes = {};
         let notice = '';
+        /** The page the current notice points at, or empty. Set only where a refusal carried one. */
+        let noticeLink = '';
         const paint = () => {
-            deps.root.innerHTML = renderStrip({ reply, notes, notice, audio: deps.audio() });
+            deps.root.innerHTML = renderStrip({ reply, notes, notice, noticeLink, audio: deps.audio() });
         };
         const refresh = async () => {
             try {
@@ -546,8 +554,19 @@ window.__ModuleLoader__.load({ id: "dsh-realtime-audio-ws",
             try {
                 const answer = await deps.request(frame);
                 // A refusal carries the reason written to be relayed verbatim, so it is relayed rather than
-                // translated — including for a field frozen by its class.
-                line = answer.ok ? done : `${answer.code ?? 'refused'}: ${answer.reason ?? 'no reason given'}`;
+                // translated — including for a field frozen by its class. A **session** refusal nests its own classified
+                // code, remedy and page and leaves the control-level `reason` unset, so reading only that answered the
+                // failure a user is most likely to meet with "refused: no reason given" — a panel saying nothing at the
+                // exact moment it knows what to do.
+                const refusal = answer.refusal;
+                if (!answer.ok && refusal !== undefined) {
+                    noticeLink = refusal.link ?? '';
+                    line = `${refusal.code ?? refusal.class ?? 'refused'}: ${refusal.remedy ?? 'no reason given'}`;
+                }
+                else {
+                    noticeLink = '';
+                    line = answer.ok ? done : `${answer.code ?? 'refused'}: ${answer.reason ?? 'no reason given'}`;
+                }
             }
             catch (error) {
                 line = error instanceof Error ? error.message : String(error);
@@ -568,6 +587,7 @@ window.__ModuleLoader__.load({ id: "dsh-realtime-audio-ws",
                 // Cleared per action: a notice from the last one is about the last one, and leaving it up would make
                 // a successful reconnect read as a failed one.
                 notice = '';
+                noticeLink = '';
                 switch (action) {
                     case 'refresh':
                         await refresh();
@@ -598,7 +618,7 @@ window.__ModuleLoader__.load({ id: "dsh-realtime-audio-ws",
             void act();
         };
         deps.root.addEventListener('click', onClick);
-        return { refresh, state: () => ({ reply, notes, notice, audio: deps.audio() }) };
+        return { refresh, state: () => ({ reply, notes, notice, noticeLink, audio: deps.audio() }) };
     }
     /**
      * The client plugin. Publishes the client and the strip on a global, and releases them with the plugin.

package/lib/client/index.js

@@ -398,8 +398,14 @@ function renderStrip(state) {
     const lines = [`<p data-dsh-strip-voice>${escapeHtml(summariseVoice(reply, state.audio))}</p>`];
     if (reply !== null)
         lines.push(`<p data-dsh-strip-route>${escapeHtml(summariseRoute(reply))}</p>`);
-    if (state.notice !== '')
-        lines.push(`<p data-dsh-strip-notice>${escapeHtml(state.notice)}</p>`);
+    if (state.notice !== '') {
+        const link = state.noticeLink ?? '';
+        const anchor = link === ''
+            ? ''
+            : ` <a data-dsh-strip-link href="${escapeHtml(link)}" target="_blank"`
+                + ' rel="noreferrer noopener">open ↗</a>';
+        lines.push(`<p data-dsh-strip-notice>${escapeHtml(state.notice)}${anchor}</p>`);
+    }
     lines.push(`<p data-dsh-strip-buttons>${buttons(state.audio)}</p>`);
     // Restart-bound settings are omitted rather than shown read-only: the gate says no control at all, and a
     // row that cannot be changed is a row a reader will try to change.
@@ -517,8 +523,10 @@ function mountStrip(deps) {
     let reply = null;
     const notes = {};
     let notice = '';
+    /** The page the current notice points at, or empty. Set only where a refusal carried one. */
+    let noticeLink = '';
     const paint = () => {
-        deps.root.innerHTML = renderStrip({ reply, notes, notice, audio: deps.audio() });
+        deps.root.innerHTML = renderStrip({ reply, notes, notice, noticeLink, audio: deps.audio() });
     };
     const refresh = async () => {
         try {
@@ -542,8 +550,19 @@ function mountStrip(deps) {
         try {
             const answer = await deps.request(frame);
             // A refusal carries the reason written to be relayed verbatim, so it is relayed rather than
-            // translated — including for a field frozen by its class.
-            line = answer.ok ? done : `${answer.code ?? 'refused'}: ${answer.reason ?? 'no reason given'}`;
+            // translated — including for a field frozen by its class. A **session** refusal nests its own classified
+            // code, remedy and page and leaves the control-level `reason` unset, so reading only that answered the
+            // failure a user is most likely to meet with "refused: no reason given" — a panel saying nothing at the
+            // exact moment it knows what to do.
+            const refusal = answer.refusal;
+            if (!answer.ok && refusal !== undefined) {
+                noticeLink = refusal.link ?? '';
+                line = `${refusal.code ?? refusal.class ?? 'refused'}: ${refusal.remedy ?? 'no reason given'}`;
+            }
+            else {
+                noticeLink = '';
+                line = answer.ok ? done : `${answer.code ?? 'refused'}: ${answer.reason ?? 'no reason given'}`;
+            }
         }
         catch (error) {
             line = error instanceof Error ? error.message : String(error);
@@ -564,6 +583,7 @@ function mountStrip(deps) {
             // Cleared per action: a notice from the last one is about the last one, and leaving it up would make
             // a successful reconnect read as a failed one.
             notice = '';
+            noticeLink = '';
             switch (action) {
                 case 'refresh':
                     await refresh();
@@ -594,7 +614,7 @@ function mountStrip(deps) {
         void act();
     };
     deps.root.addEventListener('click', onClick);
-    return { refresh, state: () => ({ reply, notes, notice, audio: deps.audio() }) };
+    return { refresh, state: () => ({ reply, notes, notice, noticeLink, audio: deps.audio() }) };
 }
 /**
  * The client plugin. Publishes the client and the strip on a global, and releases them with the plugin.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-realtime-audio-ws",
-  "version": "0.2.6",
+  "version": "0.2.7",
   "description": "The host end of the client half's transport: a WebSocket upgrade route that bridges microphone audio in and agent speech out.",
   "type": "module",
   "main": "lib/index.js",
@@ -52,8 +52,8 @@
   },
   "dependencies": {
     "ws": "^8.22.0",
-    "dsh-realtime-agent": "^0.2.10",
-    "dsh-realtime": "^0.2.6"
+    "dsh-realtime": "^0.2.7",
+    "dsh-realtime-agent": "^0.2.11"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.3",

package/src/client/index.ts

@@ -142,6 +142,19 @@ export interface ControlReplyLike {
   readonly verb?: string
   readonly code?: string
   readonly reason?: string
+  /**
+   * A *session* refusal, nested inside the reply.
+   *
+   * A control-level refusal sets `code` and `reason`; a session-level one carries its own classified code, the
+   * remedy written to be relayed, and the page the remedy is carried out on. Reading only the top level made
+   * the panel answer the failure a user is most likely to meet with "refused: no reason given".
+   */
+  readonly refusal?: {
+    readonly code?: string
+    readonly class?: string
+    readonly remedy?: string
+    readonly link?: string
+  }
   readonly key?: string
   readonly value?: unknown
   readonly voice?: { readonly open: boolean; readonly provider?: string; readonly model?: string; readonly sessionId?: string } | null
@@ -519,6 +532,15 @@ export interface StripState {
   readonly notes: Readonly<Record<string, string>>
   /** Anything with no field to belong to — a transport failure, or what a start or stop produced. */
   readonly notice: string
+  /**
+   * Where a notice points, when it points anywhere.
+   *
+   * A remedy that says "add credit" without saying where is half an instruction, and the URL lives in the
+   * provider's own message — which this design never carries. So it travels as its own field and is rendered
+   * as an anchor: the one `href` this panel emits, and it comes from the provider table, never from text a
+   * provider sent. Optional, because most notices point nowhere.
+   */
+  readonly noticeLink?: string
   /** What the microphone is doing. */
   readonly audio: ClientAudioState
 }
@@ -587,7 +609,14 @@ export function renderStrip(state: StripState): string {
   const reply = state.reply
   const lines = [`<p data-dsh-strip-voice>${escapeHtml(summariseVoice(reply, state.audio))}</p>`]
   if (reply !== null) lines.push(`<p data-dsh-strip-route>${escapeHtml(summariseRoute(reply))}</p>`)
-  if (state.notice !== '') lines.push(`<p data-dsh-strip-notice>${escapeHtml(state.notice)}</p>`)
+  if (state.notice !== '') {
+    const link = state.noticeLink ?? ''
+    const anchor = link === ''
+      ? ''
+      : ` <a data-dsh-strip-link href="${escapeHtml(link)}" target="_blank"`
+        + ' rel="noreferrer noopener">open ↗</a>'
+    lines.push(`<p data-dsh-strip-notice>${escapeHtml(state.notice)}${anchor}</p>`)
+  }
   lines.push(`<p data-dsh-strip-buttons>${buttons(state.audio)}</p>`)
   // Restart-bound settings are omitted rather than shown read-only: the gate says no control at all, and a
   // row that cannot be changed is a row a reader will try to change.
@@ -711,9 +740,11 @@ export function mountStrip(deps: StripDeps): Strip {
   let reply: ControlReplyLike | null = null
   const notes: Record<string, string> = {}
   let notice = ''
+  /** The page the current notice points at, or empty. Set only where a refusal carried one. */
+  let noticeLink = ''
 
   const paint = (): void => {
-    deps.root.innerHTML = renderStrip({ reply, notes, notice, audio: deps.audio() })
+    deps.root.innerHTML = renderStrip({ reply, notes, notice, noticeLink, audio: deps.audio() })
   }
 
   const refresh = async (): Promise<void> => {
@@ -738,8 +769,18 @@ export function mountStrip(deps: StripDeps): Strip {
     try {
       const answer = await deps.request(frame)
       // A refusal carries the reason written to be relayed verbatim, so it is relayed rather than
-      // translated — including for a field frozen by its class.
-      line = answer.ok ? done : `${answer.code ?? 'refused'}: ${answer.reason ?? 'no reason given'}`
+      // translated — including for a field frozen by its class. A **session** refusal nests its own classified
+      // code, remedy and page and leaves the control-level `reason` unset, so reading only that answered the
+      // failure a user is most likely to meet with "refused: no reason given" — a panel saying nothing at the
+      // exact moment it knows what to do.
+      const refusal = answer.refusal
+      if (!answer.ok && refusal !== undefined) {
+        noticeLink = refusal.link ?? ''
+        line = `${refusal.code ?? refusal.class ?? 'refused'}: ${refusal.remedy ?? 'no reason given'}`
+      } else {
+        noticeLink = ''
+        line = answer.ok ? done : `${answer.code ?? 'refused'}: ${answer.reason ?? 'no reason given'}`
+      }
     } catch (error) {
       line = error instanceof Error ? error.message : String(error)
     }
@@ -757,6 +798,7 @@ export function mountStrip(deps: StripDeps): Strip {
       // Cleared per action: a notice from the last one is about the last one, and leaving it up would make
       // a successful reconnect read as a failed one.
       notice = ''
+      noticeLink = ''
       switch (action) {
         case 'refresh': await refresh(); return
         case 'disconnect': deps.disconnect(); await refresh(); return
@@ -777,7 +819,7 @@ export function mountStrip(deps: StripDeps): Strip {
 
   deps.root.addEventListener('click', onClick)
 
-  return { refresh, state: () => ({ reply, notes, notice, audio: deps.audio() }) }
+  return { refresh, state: () => ({ reply, notes, notice, noticeLink, audio: deps.audio() }) }
 }
 
 /**