@yadsh/dsh-qa-surface 0.1.0

package/compatibility.json

@@ -0,0 +1,15 @@
+{
+  "deepseekHarness": {
+    "channel": "next",
+    "range": ">=0.1.1-rc.2 <0.2.0",
+    "testedReleases": ["0.1.1-rc.2"],
+    "requiredClientFeatures": [
+      "shell.overlay",
+      "connection.api.sessions",
+      "sessions.binding",
+      "settingsScope",
+      "webServer.register"
+    ]
+  },
+  "node": "^22.19.0 || >=24.0.0"
+}

package/cordis.patch.yml

@@ -0,0 +1,9 @@
+# The DSH plugin manager discovers the browser half through package.json.
+- insert:
+    - id: dsh-qa-surface
+      name: "@yadsh/dsh-qa-surface"
+      config:
+        enabled: true
+        route:
+          path: /qa
+          matchChildren: true

package/docs/ARCHITECTURE.md

@@ -0,0 +1,24 @@
+# Architecture
+
+The Host half validates the Loader configuration, registers the `qa-surface`
+settings namespace and owns one narrow GET/HEAD route for the configured QA
+path. Published DSH `0.1.1-rc.2` returns 404 for unknown frontend paths, so the
+route redirects navigation through the canonical `/` index with an encoded
+same-origin path marker. It does not serve HTML, create another server, replace
+the frontend fallback, or touch API/plugin routes. The browser removes the
+marker and restores the requested path with `history.replaceState` before
+route matching. The Host creates no sessions.
+
+The browser half registers `QaSurface` in the root-scoped `shell.overlay` list.
+`QaRouteController` keeps that entry dormant outside the configured path and
+reversibly observes `pushState`, `replaceState` and `popstate`.
+
+`QaSessionController` is the only DSH session-coupled module. It uses
+`connection.api.sessions.create/selectModel` for creation policy and the public
+`SessionFace` for prompt, cancel and snapshots. `QaTranscriptAdapter` projects
+those snapshots to plugin-local messages, excluding reasoning, tool arguments,
+tool results, system context and raw failures.
+
+The overlay locks document scrolling and contains keyboard focus while active.
+It does not locate AppFrame through generated CSS classes and does not dispose
+global DSH runtime services when the route changes.

package/docs/COMPATIBILITY.md

@@ -0,0 +1,13 @@
+# Compatibility
+
+| Plugin version | Tested DSH release | Required public contracts                                                                             |
+| -------------- | ------------------ | ----------------------------------------------------------------------------------------------------- |
+| 0.1.x          | 0.1.1-rc.2         | `shell.overlay`, `settingsScope`, `connection.api.sessions`, `sessions.binding`, `webServer.register` |
+
+DSH is developer-preview software. Compatibility-sensitive calls are isolated
+in `QaSessionController`, `QaTranscriptAdapter`, `QaConfigController` and
+`QaRouteController`. The Host navigation adapter also works around this tested
+release's exact-index static serving: `/qa` is redirected through `/`, then the
+client restores the original pathname. Missing settings fall back to default
+browser config; missing required client services prevent the browser plugin
+from being injected rather than patching DSH internals.

package/docs/CONFIGURATION.md

@@ -0,0 +1,18 @@
+# Configuration reference
+
+Defaults and constraints are documented in the root README. Important runtime
+rules are:
+
+- `route.path` starts with `/`, has trailing slashes removed, and cannot claim
+  `/`, `/api` or `/plugins`;
+- `fixed` requires `fixedSessionId`;
+- `provider` and `model` are either both absent or both present;
+- `maxContentWidth` is an integer from 480 through 1600;
+- duplicate/blank suggested questions are removed;
+- approval and question policies are fixed to safe blocking behavior;
+- reasoning display cannot be enabled in the 0.1.x MVP.
+
+Browser persistence stores only the DSH session id under
+`<storageKey>:v1:<route>:session`. Transcript content, credentials and tool
+results remain in the Host-owned DSH Session and are never copied to browser
+storage.

package/docs/EMBEDDING.md

@@ -0,0 +1,13 @@
+# Embedding and reverse proxies
+
+Serve `/qa` through the normal DSH origin so it shares the established browser
+connection, authentication and trust policy. The plugin's narrow navigation
+route redirects GET/HEAD requests through DSH's canonical `/` document; the
+client immediately restores `/qa` before mounting. Reverse proxies must pass
+the configured QA path to DSH instead of replacing it with a separately hosted
+page.
+
+Iframe embedding is disabled or allowed by deployment headers, not by this
+plugin. Configure an explicit CSP `frame-ancestors` allowlist at a trusted
+reverse proxy and keep the DSH API same-origin. Do not enable wildcard CORS or
+expose settings/session APIs without the deployment's authentication layer.

package/lib/client/QaConfigController.js

@@ -0,0 +1,65 @@
+import { DEFAULT_QA_SURFACE_CONFIG, resolveConfig } from "../resolve-config.js";
+/** Browser projection of the Host-owned qa-surface settings namespace. */
+export class QaConfigController {
+    scope;
+    listeners = new Set();
+    snapshot;
+    unsubscribe;
+    constructor(scope) {
+        this.scope = scope;
+        this.snapshot = this.project();
+        this.unsubscribe = scope.subscribe(() => this.refresh());
+    }
+    getSnapshot = () => this.snapshot;
+    subscribe = (listener) => {
+        this.listeners.add(listener);
+        return () => this.listeners.delete(listener);
+    };
+    dispose() {
+        this.unsubscribe();
+        this.listeners.clear();
+    }
+    project() {
+        const settings = this.scope.getSnapshot();
+        if (settings.status === "loading") {
+            return {
+                status: "loading",
+                config: DEFAULT_QA_SURFACE_CONFIG,
+                error: null,
+            };
+        }
+        if (settings.status === "unavailable") {
+            return {
+                status: "unavailable",
+                config: DEFAULT_QA_SURFACE_CONFIG,
+                error: null,
+            };
+        }
+        try {
+            return {
+                status: "ready",
+                config: resolveConfig(settings.value ?? {}),
+                error: null,
+            };
+        }
+        catch {
+            return {
+                status: "error",
+                config: DEFAULT_QA_SURFACE_CONFIG,
+                error: "The assistant configuration is unavailable.",
+            };
+        }
+    }
+    refresh() {
+        const next = this.project();
+        if (next.status === this.snapshot.status &&
+            next.config === this.snapshot.config &&
+            next.error === this.snapshot.error) {
+            return;
+        }
+        this.snapshot = next;
+        for (const listener of this.listeners)
+            listener();
+    }
+}
+//# sourceMappingURL=QaConfigController.js.map

package/lib/client/QaConfigController.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"QaConfigController.js","sourceRoot":"","sources":["../../src/client/QaConfigController.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,yBAAyB,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAShF,0EAA0E;AAC1E,MAAM,OAAO,kBAAkB;IAKA,KAAK;IAJjB,SAAS,GAAG,IAAI,GAAG,EAAc,CAAC;IAC3C,QAAQ,CAAmB;IAClB,WAAW,CAAa;IAEzC,YAA6B,KAAqC;qBAArC,KAAK;QAChC,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;QAC/B,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;IAC3D,CAAC;IAED,WAAW,GAAG,GAAqB,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC;IAEpD,SAAS,GAAG,CAAC,QAAoB,EAAgB,EAAE;QACjD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC7B,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC/C,CAAC,CAAC;IAEF,OAAO;QACL,IAAI,CAAC,WAAW,EAAE,CAAC;QACnB,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;IACzB,CAAC;IAEO,OAAO;QACb,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;QAC1C,IAAI,QAAQ,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAClC,OAAO;gBACL,MAAM,EAAE,SAAS;gBACjB,MAAM,EAAE,yBAAyB;gBACjC,KAAK,EAAE,IAAI;aACZ,CAAC;QACJ,CAAC;QACD,IAAI,QAAQ,CAAC,MAAM,KAAK,aAAa,EAAE,CAAC;YACtC,OAAO;gBACL,MAAM,EAAE,aAAa;gBACrB,MAAM,EAAE,yBAAyB;gBACjC,KAAK,EAAE,IAAI;aACZ,CAAC;QACJ,CAAC;QACD,IAAI,CAAC;YACH,OAAO;gBACL,MAAM,EAAE,OAAO;gBACf,MAAM,EAAE,aAAa,CAAC,QAAQ,CAAC,KAAK,IAAI,EAAE,CAAC;gBAC3C,KAAK,EAAE,IAAI;aACZ,CAAC;QACJ,CAAC;QAAC,MAAM,CAAC;YACP,OAAO;gBACL,MAAM,EAAE,OAAO;gBACf,MAAM,EAAE,yBAAyB;gBACjC,KAAK,EAAE,6CAA6C;aACrD,CAAC;QACJ,CAAC;IACH,CAAC;IAEO,OAAO;QACb,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;QAC5B,IACE,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC,QAAQ,CAAC,MAAM;YACpC,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC,QAAQ,CAAC,MAAM;YACpC,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,QAAQ,CAAC,KAAK,EAClC,CAAC;YACD,OAAO;QACT,CAAC;QACD,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS;YAAE,QAAQ,EAAE,CAAC;IACpD,CAAC;CACF"}

package/lib/client/QaRouteController.js

@@ -0,0 +1,109 @@
+import { QA_NAVIGATION_MARKER } from "../navigation-marker.js";
+export function matchesQaRoute(pathname, route) {
+    if (pathname === route.path || pathname === `${route.path}/`)
+        return true;
+    if (route.path === "/")
+        return route.matchChildren;
+    if (!route.matchChildren)
+        return false;
+    return pathname.startsWith(`${route.path}/`);
+}
+/** Observable route matcher with reversible History API instrumentation. */
+export class QaRouteController {
+    target;
+    listeners = new Set();
+    route = {
+        path: "/qa",
+        matchChildren: true,
+    };
+    enabled = false;
+    snapshot;
+    originalPushState;
+    originalReplaceState;
+    wrappedPushState;
+    wrappedReplaceState;
+    disposed = false;
+    constructor(target = window) {
+        this.target = target;
+        this.originalPushState = target.history.pushState;
+        this.originalReplaceState = target.history.replaceState;
+        this.restoreRedirectedPath();
+        this.snapshot = this.project();
+        const refresh = () => this.refresh();
+        const history = target.history;
+        const originalPushState = this.originalPushState;
+        const originalReplaceState = this.originalReplaceState;
+        this.wrappedPushState = function (...args) {
+            Reflect.apply(originalPushState, history, args);
+            refresh();
+        };
+        this.wrappedReplaceState = function (...args) {
+            Reflect.apply(originalReplaceState, history, args);
+            refresh();
+        };
+        target.history.pushState = this.wrappedPushState;
+        target.history.replaceState = this.wrappedReplaceState;
+        target.addEventListener("popstate", refresh);
+        this.removePopstate = () => target.removeEventListener("popstate", refresh);
+    }
+    removePopstate;
+    getSnapshot = () => this.snapshot;
+    subscribe = (listener) => {
+        this.listeners.add(listener);
+        return () => this.listeners.delete(listener);
+    };
+    configure(config, ready = true) {
+        this.route = config.route;
+        this.enabled = ready && config.enabled;
+        this.refresh();
+    }
+    dispose() {
+        if (this.disposed)
+            return;
+        this.disposed = true;
+        this.removePopstate();
+        if (this.target.history.pushState === this.wrappedPushState) {
+            this.target.history.pushState = this.originalPushState;
+        }
+        if (this.target.history.replaceState === this.wrappedReplaceState) {
+            this.target.history.replaceState = this.originalReplaceState;
+        }
+        this.listeners.clear();
+    }
+    project() {
+        const pathname = this.target.location.pathname;
+        return {
+            pathname,
+            active: this.enabled && matchesQaRoute(pathname, this.route),
+        };
+    }
+    restoreRedirectedPath() {
+        const search = this.target.location.search;
+        if (search === undefined || search === "")
+            return;
+        const requested = new URLSearchParams(search).get(QA_NAVIGATION_MARKER);
+        if (requested === null ||
+            !requested.startsWith("/") ||
+            requested.startsWith("//")) {
+            return;
+        }
+        Reflect.apply(this.originalReplaceState, this.target.history, [
+            null,
+            "",
+            requested,
+        ]);
+    }
+    refresh() {
+        if (this.disposed)
+            return;
+        const next = this.project();
+        if (next.pathname === this.snapshot.pathname &&
+            next.active === this.snapshot.active) {
+            return;
+        }
+        this.snapshot = next;
+        for (const listener of this.listeners)
+            listener();
+    }
+}
+//# sourceMappingURL=QaRouteController.js.map

package/lib/client/QaRouteController.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"QaRouteController.js","sourceRoot":"","sources":["../../src/client/QaRouteController.ts"],"names":[],"mappings":"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"}

package/lib/client/QaSessionController.js

@@ -0,0 +1,366 @@
+import { projectTranscript } from "./QaTranscriptAdapter.js";
+const EMPTY_STATE = Object.freeze({
+    phase: "idle",
+    sessionId: null,
+    messages: Object.freeze([]),
+    error: null,
+    canSend: false,
+    canStop: false,
+});
+function waitFor(source, predicate, timeoutMs) {
+    const current = source.getSnapshot();
+    if (predicate(current))
+        return Promise.resolve(current);
+    return new Promise((resolve, reject) => {
+        let settled = false;
+        const timeout = {};
+        let unsubscribe = () => undefined;
+        const finish = (value) => {
+            if (settled)
+                return;
+            settled = true;
+            if (timeout.id !== undefined)
+                clearTimeout(timeout.id);
+            unsubscribe();
+            resolve(value);
+        };
+        unsubscribe = source.subscribe(() => {
+            const next = source.getSnapshot();
+            if (predicate(next))
+                finish(next);
+        });
+        // Tolerate observable implementations that notify synchronously while a
+        // subscriber is being installed, and close that subscription afterward.
+        if (settled) {
+            unsubscribe();
+            return;
+        }
+        const afterSubscribe = source.getSnapshot();
+        if (predicate(afterSubscribe)) {
+            finish(afterSubscribe);
+            return;
+        }
+        timeout.id = setTimeout(() => {
+            if (settled)
+                return;
+            settled = true;
+            unsubscribe();
+            reject(new Error("Timed out waiting for the DSH runtime."));
+        }, timeoutMs);
+    });
+}
+/** The only module that couples QA behavior to DSH Session/client APIs. */
+export class QaSessionController {
+    listeners = new Set();
+    sessions;
+    api;
+    connection;
+    config;
+    storage;
+    timeoutMs;
+    state = EMPTY_STATE;
+    session;
+    unsubscribeSession;
+    unsubscribeConnection;
+    ensuring;
+    operationError = null;
+    admissionPending = false;
+    connectedOnce;
+    disposed = false;
+    generation = 0;
+    constructor(options) {
+        this.sessions = options.sessions;
+        this.api = options.api;
+        this.connection = options.connection;
+        this.config = options.config;
+        this.storage = options.storage;
+        this.timeoutMs = options.timeoutMs ?? 15_000;
+        this.connectedOnce = this.connection.getSnapshot() !== undefined;
+        this.unsubscribeConnection = this.connection.subscribe(() => {
+            if (this.connection.getSnapshot() !== undefined)
+                this.connectedOnce = true;
+            this.publish();
+        });
+    }
+    getSnapshot = () => this.state;
+    subscribe = (listener) => {
+        this.listeners.add(listener);
+        return () => this.listeners.delete(listener);
+    };
+    ensureSession() {
+        if (this.ensuring !== undefined)
+            return this.ensuring;
+        const operation = this.ensureSessionNow().finally(() => {
+            if (this.ensuring === operation)
+                this.ensuring = undefined;
+        });
+        this.ensuring = operation;
+        return operation;
+    }
+    async send(text) {
+        const prompt = text.trim();
+        if (prompt === "" || this.session === undefined || !this.state.canSend) {
+            return false;
+        }
+        if (prompt.startsWith("/")) {
+            this.operationError =
+                "Slash commands are not available in this assistant view.";
+            this.publish();
+            return false;
+        }
+        this.operationError = null;
+        this.admissionPending = true;
+        this.publish();
+        try {
+            const result = await this.session.prompt([{ type: "text", text: prompt }], "queue");
+            if (!result.ok) {
+                this.admissionPending = false;
+                this.operationError = "Your message could not be sent.";
+                this.publish();
+                return false;
+            }
+            this.publish();
+            return true;
+        }
+        catch (error) {
+            this.admissionPending = false;
+            console.error("dsh-qa-surface: prompt failed", error);
+            this.operationError = "Your message could not be sent.";
+            this.publish();
+            return false;
+        }
+    }
+    async stop() {
+        if (this.session === undefined || !this.state.canStop)
+            return;
+        try {
+            const result = await this.session.cancel();
+            if (!result.ok)
+                this.operationError = "The response could not be stopped.";
+        }
+        catch (error) {
+            console.error("dsh-qa-surface: stop failed", error);
+            this.operationError = "The response could not be stopped.";
+        }
+        this.publish();
+    }
+    async reset() {
+        if (this.config.session.policy === "fixed")
+            return;
+        const previous = this.session;
+        if (previous?.getSnapshot().running === true) {
+            try {
+                await previous.cancel();
+            }
+            catch (error) {
+                console.error("dsh-qa-surface: stop before reset failed", error);
+            }
+        }
+        const operation = ++this.generation;
+        this.unbind();
+        this.operationError = null;
+        this.admissionPending = false;
+        this.state = { ...EMPTY_STATE, phase: "creating" };
+        this.emit();
+        try {
+            await this.waitForConnection();
+            const id = await this.createSession();
+            if (this.disposed || operation !== this.generation)
+                return;
+            this.persist(id);
+            await this.bind(id);
+        }
+        catch (error) {
+            this.fail("Unable to start a new chat.", error);
+        }
+    }
+    dispose() {
+        if (this.disposed)
+            return;
+        this.disposed = true;
+        this.generation += 1;
+        this.unsubscribeConnection();
+        this.unbind();
+        this.listeners.clear();
+    }
+    async ensureSessionNow() {
+        const operation = ++this.generation;
+        this.state = { ...EMPTY_STATE, phase: "creating" };
+        this.emit();
+        try {
+            await this.waitForConnection();
+            const list = await waitFor(this.sessions.list, (snapshot) => snapshot.phase === "ready", this.timeoutMs);
+            let id = null;
+            if (this.config.session.policy === "fixed") {
+                id = this.config.session.fixedSessionId;
+                if (id === null || !Object.hasOwn(list.byId, id)) {
+                    throw new Error("Configured fixed session is unavailable.");
+                }
+            }
+            else if (this.config.session.policy === "browser-persistent") {
+                const stored = this.readPersisted();
+                if (stored !== null && Object.hasOwn(list.byId, stored)) {
+                    id = stored;
+                }
+                else if (stored !== null) {
+                    this.clearPersisted();
+                }
+            }
+            if (id === null) {
+                id = await this.createSession();
+                if (this.config.session.policy === "browser-persistent")
+                    this.persist(id);
+            }
+            if (this.disposed || operation !== this.generation)
+                return;
+            await this.bind(id);
+        }
+        catch (error) {
+            this.fail("Unable to start a chat.", error);
+        }
+    }
+    async createSession() {
+        const response = await this.api.create({
+            ...(this.config.session.workspaceId === null
+                ? {}
+                : { workspaceId: this.config.session.workspaceId }),
+            ...(this.config.session.agentPreset === null
+                ? {}
+                : { agentPreset: this.config.session.agentPreset }),
+        });
+        if (!response.result.ok)
+            throw new Error(response.result.error.code);
+        const id = String(response.result.value.sessionId);
+        await waitFor(this.sessions.list, (snapshot) => Object.hasOwn(snapshot.byId, id), this.timeoutMs);
+        if (this.config.session.provider !== null &&
+            this.config.session.model !== null) {
+            const selected = await this.api.selectModel({
+                sessionId: id,
+                provider: this.config.session.provider,
+                model: this.config.session.model,
+                ...(this.config.session.reasoningEffort === null
+                    ? {}
+                    : { reasoningEffort: this.config.session.reasoningEffort }),
+            });
+            if (!selected.result.ok)
+                throw new Error(selected.result.error.code);
+        }
+        return id;
+    }
+    async bind(id) {
+        this.sessions.open(id);
+        let binding = this.sessions.binding(id);
+        if (binding === undefined) {
+            await waitFor(this.sessions.list, (snapshot) => Object.hasOwn(snapshot.byId, id), this.timeoutMs);
+            binding = this.sessions.binding(id);
+        }
+        if (binding === undefined)
+            throw new Error("Session binding is unavailable.");
+        this.unbind();
+        this.session = binding.session;
+        this.unsubscribeSession = binding.session.subscribe(() => {
+            this.admissionPending = false;
+            this.operationError = null;
+            this.publish();
+        });
+        this.publish();
+    }
+    unbind() {
+        this.unsubscribeSession?.();
+        this.unsubscribeSession = undefined;
+        this.session = undefined;
+        this.admissionPending = false;
+    }
+    waitForConnection() {
+        return waitFor(this.connection, (description) => description !== undefined, this.timeoutMs);
+    }
+    publish() {
+        if (this.disposed)
+            return;
+        const connected = this.connection.getSnapshot() !== undefined;
+        if (this.session === undefined) {
+            this.state = {
+                ...this.state,
+                phase: !connected && this.connectedOnce ? "reconnecting" : this.state.phase,
+                error: this.operationError ?? this.state.error,
+            };
+            this.emit();
+            return;
+        }
+        const snapshot = this.session.getSnapshot();
+        const blocked = snapshot.pending.length > 0;
+        const error = this.operationError ??
+            (blocked
+                ? "This request requires an interaction that is not available in this assistant view."
+                : snapshot.removed || snapshot.openState === "error"
+                    ? "This chat is no longer available."
+                    : null);
+        const phase = !connected
+            ? "reconnecting"
+            : blocked
+                ? "blocked"
+                : snapshot.removed || snapshot.openState === "error"
+                    ? "error"
+                    : snapshot.openState !== "open"
+                        ? "creating"
+                        : snapshot.running || this.admissionPending
+                            ? "running"
+                            : "ready";
+        this.state = {
+            phase,
+            sessionId: String(this.session.sessionId),
+            messages: projectTranscript(snapshot, {
+                showToolActivity: this.config.ui.showToolActivity,
+            }),
+            error,
+            canSend: connected && phase === "ready",
+            canStop: connected && snapshot.running && this.config.ui.showStop && !blocked,
+        };
+        this.emit();
+    }
+    fail(message, error) {
+        console.error("dsh-qa-surface: session operation failed", error);
+        if (this.disposed)
+            return;
+        this.operationError = message;
+        this.state = {
+            ...EMPTY_STATE,
+            phase: "error",
+            error: message,
+        };
+        this.emit();
+    }
+    storageKey() {
+        return `${this.config.session.storageKey}:v1:${this.config.route.path}:session`;
+    }
+    readPersisted() {
+        try {
+            const value = this.storage?.getItem(this.storageKey())?.trim() ?? "";
+            return value === "" ? null : value;
+        }
+        catch {
+            return null;
+        }
+    }
+    persist(id) {
+        try {
+            this.storage?.setItem(this.storageKey(), id);
+        }
+        catch {
+            // A denied localStorage write must not prevent a real DSH session.
+        }
+    }
+    clearPersisted() {
+        try {
+            this.storage?.removeItem(this.storageKey());
+        }
+        catch {
+            // A denied localStorage removal is harmless; the id is revalidated later.
+        }
+    }
+    emit() {
+        for (const listener of this.listeners)
+            listener();
+    }
+}
+//# sourceMappingURL=QaSessionController.js.map