@yadsh/dsh-qa-surface 0.7.0 → 0.7.1

package/lib/types/client/admin/routes.d.ts

@@ -35,6 +35,16 @@ export type QaAdminRoute = {
 } | {
     readonly page: "audit";
 };
+/** The console's own base path under the surface route. */
+export declare function adminBasePath(routePath: string): string;
+/**
+ * Whether a pathname addresses the console at all. Sections and entities each
+ * own a path under the base ({@link adminPath}), and the surface hosting the
+ * console must stay the console while any of them is open, so the test is by
+ * prefix. An equality test against the base alone unmounts the console on the
+ * first navigation inside it, and every deep link lands in the chat instead.
+ */
+export declare function isAdminPath(pathname: string, routePath: string): boolean;
 /** Path segments after `/qa/admin`, without the leading slash. */
 export declare function adminSegments(pathname: string, routePath: string): string[];
 /**

package/lib/types/client/settings-extensions/index.d.ts

@@ -1,3 +1,5 @@
 export type { QaUserSettingsSectionProps, QaUserSettingsSectionRegistration, QaUserSettingsSections, QaUserSettingsSectionsContext, QaUserSettingsSectionsSnapshot, } from "./contract.js";
 export { QaUserSettingsSectionRegistry } from "./registry.js";
+export type { QaUserSession, QaUserSessionSnapshot, QaUserSessionStage, } from "./user-session.js";
+export { QaUserSessionMirror } from "./user-session.js";
 //# sourceMappingURL=index.d.ts.map

package/lib/types/client/settings-extensions/user-session.d.ts

@@ -0,0 +1,59 @@
+import type { QaAccountsController } from "../QaAccountsController.js";
+/**
+ * The signed-in QA account, as a client service.
+ *
+ * A QA panel plugin receives the account token through its panel props. A card
+ * mounted in the host's own settings (`settings.plugin.item`) has no panel to
+ * read it from, so this service is the one place such a surface asks whether a
+ * QA account is signed in and obtains the bearer credential the
+ * principal-scoped QA remotes authorize with.
+ *
+ * The credential is transport authentication only: a consumer must not persist
+ * it, log it, or place it in a URL, a tool argument, or any model-visible
+ * value.
+ */
+/** How far the account got. `checking` is the boot state before the stored token has been answered for. */
+export type QaUserSessionStage = "checking" | "anonymous" | "authed";
+/** What a browser half outside the QA overlay needs to speak to QA remotes. */
+export type QaUserSessionSnapshot = {
+    readonly stage: "checking";
+    readonly token: null;
+} | {
+    readonly stage: "anonymous";
+    readonly token: null;
+} | {
+    readonly stage: "authed";
+    /** Bearer credential for principal-scoped QA remotes. */
+    readonly token: string;
+};
+/** Read-only view of the current QA account, exposed as a client service. */
+export interface QaUserSession {
+    readonly subscribe: (listener: () => void) => () => void;
+    readonly getSnapshot: () => QaUserSessionSnapshot;
+}
+declare module "@deepseek-ai/cordis" {
+    interface Context {
+        qaUserSession: QaUserSession;
+    }
+}
+/**
+ * Publishes the account state of the controller the QA overlay mounts. The
+ * service lives for the whole host page while the controller is rebuilt
+ * whenever the remote wiring re-injects, so {@link attach} swaps the source and
+ * republishes; an unattached mirror stays in `checking`, which is what a card
+ * that mounts before the accounts subsystem sees.
+ */
+export declare class QaUserSessionMirror implements QaUserSession {
+    private controller;
+    private unsubscribeSource;
+    private snapshot;
+    private readonly listeners;
+    /** Bind the controller whose account state this view publishes. */
+    attach(controller: QaAccountsController | undefined): void;
+    dispose(): void;
+    readonly getSnapshot: () => QaUserSessionSnapshot;
+    readonly subscribe: (listener: () => void) => (() => void);
+    private publish;
+    private derive;
+}
+//# sourceMappingURL=user-session.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yadsh/dsh-qa-surface",
-  "version": "0.7.0",
+  "version": "0.7.1",
   "description": "A focused end-user QA surface backed by native DeepSeek Harness sessions",
   "repository": {
     "type": "git",
@@ -174,8 +174,8 @@
     "tsdown": "^0.22.14",
     "typescript": "^7.0.2",
     "vitest": "^4.1.11",
-    "@yadsh/dsh-config": "^0.0.0",
     "@yadsh/dsh-plugin-kit": "^0.1.0",
+    "@yadsh/dsh-config": "^0.0.0",
     "@yadsh/dsh-plugin-scripts": "^0.0.0"
   },
   "publishConfig": {