@yadsh/dsh-qa-surface 0.16.0 → 0.17.0

package/lib/types/provenance/file-preview.d.ts

@@ -40,6 +40,7 @@ export interface QaSourceFilePreviewRequest {
     readonly attachmentRoot?: string;
     readonly maxBytes: number;
     readonly maxMarkdownRenderBytes: number;
+    readonly renderFrontmatter?: boolean;
 }
 /** A file request the panel may make: the chat's own tree or a shared root. */
 export interface QaAllowedFileRequest {
@@ -77,7 +78,7 @@ export declare function resolveAllowedFile({ filePath, cwd, sharedReadOnlyRoots,
  * same way before it is matched, or a file inside the chat's own workspace is
  * refused as foreign evidence.
  */
-export declare function readSourceFilePreview({ sourcePath, cwd, isEvidence, sharedReadOnlyRoots, attachmentRoot, maxBytes, maxMarkdownRenderBytes, }: QaSourceFilePreviewRequest): Promise<QaSourceFilePreview>;
+export declare function readSourceFilePreview({ sourcePath, cwd, isEvidence, sharedReadOnlyRoots, attachmentRoot, maxBytes, maxMarkdownRenderBytes, renderFrontmatter, }: QaSourceFilePreviewRequest): Promise<QaSourceFilePreview>;
 /** One directory request from the files panel. */
 export interface QaWorkspaceListRequest {
     /** The directory to list, absolute or relative to the chat cwd. Empty = root. */

package/lib/types/provenance/source-content.d.ts

@@ -0,0 +1,19 @@
+/** Text retained from a single addressed tool result, never from model prose. */
+export declare const MAX_SOURCE_CONTENT = 32000;
+type RecordValue = Record<string, unknown>;
+export declare function retainedSourceContent(value: string | undefined, partial?: boolean): {
+    content?: undefined;
+    contentTruncated?: undefined;
+} | {
+    content: string;
+    contentTruncated: boolean;
+};
+export declare function structuredSourceContent(item: RecordValue): {
+    content?: undefined;
+    contentTruncated?: undefined;
+} | {
+    content: string;
+    contentTruncated: boolean;
+};
+export {};
+//# sourceMappingURL=source-content.d.ts.map

package/lib/types/provenance/source-image.d.ts

@@ -0,0 +1,4 @@
+import { type QaSourceFilePreviewRequest } from "./file-preview.js";
+/** The image must be named by an attested Markdown file and stay inside allowed roots. */
+export declare function readSourceImage(request: QaSourceFilePreviewRequest, imagePath: string): Promise<string>;
+//# sourceMappingURL=source-image.d.ts.map

package/lib/types/provenance/spreadsheet-preview.d.ts

@@ -0,0 +1,5 @@
+import type { QaDocumentPreviewRequest } from "./document-preview.js";
+import type { QaSpreadsheetPreview } from "../types.js";
+/** Reuse the agent's bounded parser and the panel's canonical root fence. */
+export declare function previewSpreadsheetDocument(request: QaDocumentPreviewRequest): Promise<QaSpreadsheetPreview>;
+//# sourceMappingURL=spreadsheet-preview.d.ts.map

package/lib/types/provenance/types.d.ts

@@ -33,6 +33,9 @@ export interface QaSourceReference {
     readonly uri?: string;
     readonly path?: string;
     readonly snippet?: string;
+    /** Bounded text actually returned for this source by a retrieval tool. */
+    readonly content?: string;
+    readonly contentTruncated?: boolean;
     readonly locations: readonly QaSourceLocation[];
     readonly evidence: QaSourceEvidence;
     readonly origins: readonly QaSourceOrigin[];

package/lib/types/questions.d.ts

@@ -62,9 +62,10 @@ export declare class QaQuestionGate {
     private readonly interactive;
     private readonly ownership;
     private readonly logger;
+    private readonly questionsAllowed;
     private readonly pending;
     private readonly disposers;
-    constructor(ctx: Context, interactive: () => boolean, ownership: QaSessionOwnership, logger: PluginLogger);
+    constructor(ctx: Context, interactive: () => boolean, ownership: QaSessionOwnership, logger: PluginLogger, questionsAllowed?: (agent: Agent) => boolean);
     /** Claim question requests for the chats this deployment answers. */
     install(): void;
     /** Questions of one chat, oldest first: what the QA view renders. */

package/lib/types/shared/documents.d.ts

@@ -17,4 +17,6 @@ export declare const QA_PDF_MEDIA_TYPE = "application/pdf";
  * previewable (Markdown as text, PDF through the browser's own viewer).
  */
 export declare function isConvertibleDocument(mediaType: string): boolean;
+export declare function isSpreadsheetDocument(mediaType: string): boolean;
+export declare function isPreviewableDocument(mediaType: string): boolean;
 //# sourceMappingURL=documents.d.ts.map

package/lib/types/types/accounts.d.ts

@@ -134,8 +134,10 @@ export type QaServiceTokenScope = "ask" | "sessions:read";
 export interface QaServiceTokenCreateInput {
     /** A note the operator's list shows; empty becomes a generic label. */
     readonly label?: string;
-    /** Requested scopes; unknown ones are dropped, empty falls back to `ask`. */
+    /** Requested scopes; unknown ones are dropped, explicit empty grants none. */
     readonly scopes?: readonly string[];
+    /** Whether API turns may ask clarifying questions; omitted preserves existing behavior. */
+    readonly allowClarifications?: boolean;
     /** How long the token lives, in days; bounded server-side. */
     readonly ttlDays?: number;
 }
@@ -148,6 +150,8 @@ export interface QaServiceTokenSummary {
     readonly id: string;
     readonly label: string;
     readonly scopes: readonly QaServiceTokenScope[];
+    /** Older Hosts omit this field and keep clarifications enabled. */
+    readonly allowClarifications?: boolean;
     readonly createdAt: string;
     readonly expiresAt: string;
     readonly lastUsedAt: string | null;

package/lib/types/types/answer-review.d.ts

@@ -0,0 +1,11 @@
+/** Host-recorded review of one immutable assistant message. */
+export interface QaAnswerReview {
+    readonly version: 1;
+    readonly candidateSeq: number;
+    readonly candidateHash: string;
+    readonly requestSeq: number | null;
+    readonly round: number;
+    readonly status: "reviewing" | "recovering" | "pass" | "revise" | "failure" | "cancelled" | "waived";
+    readonly at: number;
+}
+//# sourceMappingURL=answer-review.d.ts.map

package/lib/types/types/config.d.ts

@@ -38,6 +38,8 @@ export interface QaSourcesConfig {
     readonly filePreview?: {
         readonly enabled?: boolean;
         readonly markdownRenderedByDefault?: boolean;
+        /** Render a leading YAML mapping as a document metadata card. */
+        readonly renderFrontmatter?: boolean;
         readonly allowRawToggle?: boolean;
         readonly maxBytes?: number;
         readonly maxMarkdownRenderBytes?: number;
@@ -534,6 +536,7 @@ export interface ResolvedQaSurfaceConfig {
         readonly filePreview: {
             readonly enabled: boolean;
             readonly markdownRenderedByDefault: boolean;
+            readonly renderFrontmatter: boolean;
             readonly allowRawToggle: boolean;
             readonly maxBytes: number;
             readonly maxMarkdownRenderBytes: number;

package/lib/types/types/session.d.ts

@@ -9,18 +9,32 @@ export interface QaSourceFilePreview {
     readonly markdown: boolean;
     readonly renderableMarkdown: boolean;
     readonly document?: QaDocumentPreview;
+    readonly frontmatter?: import("../markdown-frontmatter.js").MarkdownFrontmatter;
 }
 /**
- * A file the panel renders by conversion rather than by bytes: the document
- * pipeline turned a Word file into PDF, and the browser shows that PDF.
+ * A PDF payload, including Word documents rendered by the document pipeline.
  */
-export interface QaDocumentPreview {
+export interface QaPdfPreview {
     readonly kind: "pdf";
     readonly base64: string;
     readonly mime: "application/pdf";
     readonly name: string;
     readonly bytes: number;
 }
+/** A bounded cell window; the complete workbook stays on the Host. */
+export interface QaSpreadsheetPreview {
+    readonly kind: "spreadsheet";
+    readonly name: string;
+    readonly bytes: number;
+    readonly inventory: import("@yadsh/dsh-documents").SpreadsheetInspectResult;
+    readonly page: import("@yadsh/dsh-documents").SpreadsheetReadResult;
+}
+export interface QaSpreadsheetPreviewSelection {
+    readonly sheet?: string;
+    readonly startRow?: number;
+    readonly startColumn?: number;
+}
+export type QaDocumentPreview = QaPdfPreview | QaSpreadsheetPreview;
 /** One directory entry of a chat's own workspace, as the files panel browses it. */
 export interface QaWorkspaceEntry {
     readonly name: string;
@@ -111,6 +125,7 @@ export type QaMessage = QaUserMessage | {
      * while the browser's own message id does not.
      */
     readonly seq?: number;
+    readonly review?: import("./answer-review.js").QaAnswerReview;
     /** Final text of a completed turn with a durable fork boundary. */
     readonly forkable?: boolean;
     /** Host turn this answer belongs to; groups regenerations into variants. */

package/lib/types/types.d.ts

@@ -8,6 +8,7 @@ export type * from "./types/config.js";
 export type * from "./types/slash.js";
 export type * from "./types/documents.js";
 export type * from "./types/session.js";
+export type * from "./types/answer-review.js";
 export type * from "./types/quality.js";
 export type * from "./types/admin.js";
 export type { QaSourceEvidence, QaSourceKind, QaSourceLocation, QaSourceOrigin, QaSourceReference, QaTurnSources, } from "./provenance/types.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yadsh/dsh-qa-surface",
-  "version": "0.16.0",
+  "version": "0.17.0",
   "description": "A focused end-user QA surface backed by native DeepSeek Harness sessions",
   "repository": {
     "type": "git",
@@ -137,9 +137,9 @@
     "yaml": "^2.9.0",
     "zod": "^4.4.3",
     "@yadsh/dsh-audit-core": "^0.1.2",
-    "@yadsh/dsh-plugin-kit": "^0.5.1",
-    "@yadsh/dsh-documents": "^0.7.0",
     "@yadsh/dsh-audit-ui": "^0.1.3",
+    "@yadsh/dsh-documents": "^0.8.0",
+    "@yadsh/dsh-plugin-kit": "^0.6.0",
     "@yadsh/dsh-plugin-log": "^0.4.2"
   },
   "devDependencies": {