@av-pi-studio/client 0.0.105 → 0.0.107

package/dist/pistudio-client.d.ts

@@ -1,4 +1,4 @@
-import type { AgentCloneResponse, AgentCompactResponse, AgentCycleModelResponse, AgentExportHtmlResponse, AgentForkMessagesResponse, AgentForkResponse, AgentLastAssistantTextResponse, AgentListCommandsResponse, AgentNewSessionResponse, AgentSessionStatsResponse, AgentSetModelResponse, AgentSetSessionNameResponse, AgentSetThinkingResponse, AgentStreamEvent, AgentSwitchSessionResponse, AgentThinkingLevelsResponse, AgentUiPendingRequest, AgentUiRequest, AgentUiResolved, AgentUiResponse, AgentUiSurface, CreateAgentRequest, ExtensionPacksListResponse, ExtensionPacksSetResponse, FetchAgentTimelineResponse, ProviderAuthInfo, ProviderAuthType, SessionMessage, TimelineDirection } from "@av-pi-studio/protocol";
+import type { AgentCloneResponse, AgentCompactResponse, AgentCycleModelResponse, AgentExportHtmlResponse, AgentForkMessagesResponse, AgentForkResponse, AgentLastAssistantTextResponse, AgentListCommandsResponse, AgentNewSessionResponse, AgentSessionStatsResponse, AgentSetModelResponse, AgentSetSessionNameResponse, AgentSetThinkingResponse, AgentStreamEvent, AgentSwitchSessionResponse, AgentThinkingLevelsResponse, AgentUiPendingRequest, AgentUiRequest, AgentUiResolved, AgentUiResponse, AgentUiSurface, CreateAgentRequest, ExtensionPacksListResponse, ExtensionPacksSetResponse, FetchAgentTimelineResponse, ProviderAuthInfo, ProviderAuthType, SessionMessage, TimelineDirection, ViewerSettings, ViewerSettingsPatchEntry } from "@av-pi-studio/protocol";
 import type { DaemonClient } from "./daemon-client.js";
 /**
  * High-level `PiStudioClient` SDK facade over the low-level `DaemonClient` driver.
@@ -352,6 +352,8 @@ export interface AgentDeletedMessage {
 export declare function isAgentArchived(message: unknown): message is AgentArchivedMessage;
 /** Narrows an inbound session message to `agent_deleted`. See `isAgentArchived`. */
 export declare function isAgentDeleted(message: unknown): message is AgentDeletedMessage;
+/** A `viewer_settings_set_request`'s patch body — per-viewer, both fields optional. */
+export type ViewerSettingsPatch = Record<string, ViewerSettingsPatchEntry>;
 export declare class PiStudioClient {
     private readonly daemon;
     /** Exactly one login flow per client instance, per `swe/features/provider-auth-rpc.md`. */
@@ -427,6 +429,18 @@ export declare class PiStudioClient {
     /** The single place a flow ends. Idempotent — whichever path (a `done` event, a lost connection,
      *  an immediate login rejection) settles it first wins; releases every subscription exactly once. */
     private settleProviderAuthFlow;
+    /** True iff the daemon advertised the `viewerSettings` capability in `server_info.features`.
+     *  A `false` result means "treat every viewer as enabled", never "no viewers available" — the
+     *  degrade direction always offers a viewer, never hides one behind a daemon version. */
+    hasViewerSettingsCapability(): boolean;
+    /** The current per-viewer enable/disable document. */
+    getViewerSettings(): Promise<ViewerSettings>;
+    /** Patches one or more viewer rows; resolves to the EFFECTIVE document after the daemon's
+     *  merge, never an echo of `patch`. */
+    setViewerSettings(patch: ViewerSettingsPatch): Promise<ViewerSettings>;
+    /** Subscribe to the daemon's `viewer_settings_update` broadcast — every viewer-settings change
+     *  on this daemon, from any session, including this client's own. */
+    onViewerSettingsUpdate(handler: (settings: ViewerSettings) => void): () => void;
     /**
      * Subscribe to every `agent_ui_request` broadcast (any agent) — a new dialog, a fire-and-forget
      * UI event, or a surface upsert/clear. `meta.receivedAt` is stamped here, not forwarded from the

package/dist/pistudio-client.js

@@ -365,6 +365,33 @@ export class PiStudioClient {
             this.activeProviderAuthFlow = null;
         flow.settle(result);
     }
+    // ─── Viewer settings (viewer_settings_*, sprint-073) ───────────────────────
+    /** True iff the daemon advertised the `viewerSettings` capability in `server_info.features`.
+     *  A `false` result means "treat every viewer as enabled", never "no viewers available" — the
+     *  degrade direction always offers a viewer, never hides one behind a daemon version. */
+    hasViewerSettingsCapability() {
+        return this.daemon.hasFeature("viewerSettings");
+    }
+    /** The current per-viewer enable/disable document. */
+    async getViewerSettings() {
+        const payload = await this.daemon.request("viewer_settings_get_request", {});
+        return payload.settings;
+    }
+    /** Patches one or more viewer rows; resolves to the EFFECTIVE document after the daemon's
+     *  merge, never an echo of `patch`. */
+    async setViewerSettings(patch) {
+        const payload = await this.daemon.request("viewer_settings_set_request", { patch });
+        return payload.settings;
+    }
+    /** Subscribe to the daemon's `viewer_settings_update` broadcast — every viewer-settings change
+     *  on this daemon, from any session, including this client's own. */
+    onViewerSettingsUpdate(handler) {
+        return this.daemon.onSessionMessage((msg) => {
+            if (msg.type === "viewer_settings_update") {
+                handler(msg.settings);
+            }
+        });
+    }
     // ─── Extension UI (agent_ui_*, sprint-066) ─────────────────────────────────
     /**
      * Subscribe to every `agent_ui_request` broadcast (any agent) — a new dialog, a fire-and-forget

package/dist/test-support/scripted-daemon.js

@@ -226,6 +226,25 @@ export function makeScriptedDaemon(opts) {
                 });
                 return;
             }
+            case "viewer_settings_get_request": {
+                reply({
+                    type: "viewer_settings_get_response",
+                    requestId,
+                    payload: { settings: { version: 1, viewers: {} } },
+                });
+                return;
+            }
+            case "viewer_settings_set_request": {
+                // Echoes the patch verbatim as the "effective document" — sufficient for the facade's
+                // pass-through tests; the real merge semantics are tested against the daemon
+                // (viewer-settings-rpc.test.ts), not re-tested here.
+                reply({
+                    type: "viewer_settings_set_response",
+                    requestId,
+                    payload: { settings: { version: 1, viewers: msg.patch } },
+                });
+                return;
+            }
             default:
                 reply({ type: `${String(msg.type)}_response`, requestId, payload: { ok: true } });
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@av-pi-studio/client",
-  "version": "0.0.105",
+  "version": "0.0.107",
   "files": [
     "dist",
     "!dist/**/*.map",
@@ -20,7 +20,7 @@
     "clean": "rm -rf dist *.tsbuildinfo"
   },
   "dependencies": {
-    "@av-pi-studio/protocol": "^0.0.105",
-    "@av-pi-studio/relay": "^0.0.105"
+    "@av-pi-studio/protocol": "^0.0.107",
+    "@av-pi-studio/relay": "^0.0.107"
   }
 }