@yadsh/dsh-qa-surface 0.1.1 → 0.2.0

package/lib/types/types.d.ts

@@ -1,4 +1,7 @@
 export type QaSessionPolicy = "browser-persistent" | "new-on-load" | "fixed";
+export type QaSandboxMode = "read-only";
+export type QaApprovalPolicy = "never";
+export type QaToolPolicyMode = "allow-list";
 export interface QaSurfaceConfig {
     readonly enabled?: boolean;
     readonly route?: {
@@ -11,10 +14,14 @@ export interface QaSurfaceConfig {
         readonly welcomeMessage?: string;
         readonly placeholder?: string;
         readonly logoUrl?: string | null;
+        /** Data-usage notice under the composer; empty string hides the plate. */
+        readonly disclaimer?: string | null;
     };
     readonly session?: {
         readonly policy?: QaSessionPolicy;
         readonly storageKey?: string;
+        /** Absolute directory pinned as the session cwd (alternative to workspaceId). */
+        readonly cwd?: string | null;
         readonly workspaceId?: string | null;
         readonly fixedSessionId?: string | null;
         readonly agentPreset?: string | null;
@@ -31,12 +38,33 @@ export interface QaSurfaceConfig {
         readonly showReasoning?: boolean;
         readonly renderMarkdown?: boolean;
         readonly maxContentWidth?: number;
+        readonly showSessionList?: boolean;
     };
     readonly suggestedQuestions?: readonly string[];
     readonly interaction?: {
         readonly approvals?: "blocked";
         readonly questions?: "unsupported";
     };
+    readonly lockdown?: {
+        readonly enabled?: boolean;
+        readonly enforceFixedAgentPreset?: boolean;
+        readonly enforceFixedWorkspace?: boolean;
+        readonly enforceFixedModel?: boolean;
+        readonly sandboxMode?: QaSandboxMode;
+        readonly approvalPolicy?: QaApprovalPolicy;
+        readonly permissionPreset?: string;
+        readonly allowPermissionChanges?: false;
+        readonly allowSlashCommands?: false;
+        readonly allowSettingsMutation?: false;
+        readonly allowSessionReset?: boolean;
+        readonly allowSessionRename?: false;
+        readonly allowSessionDelete?: false;
+        readonly allowArbitrarySessionOpen?: false;
+        readonly toolPolicy?: {
+            readonly mode?: QaToolPolicyMode;
+            readonly allow?: readonly string[];
+        };
+    };
     readonly embedding?: {
         readonly frameAncestors?: string | null;
     };
@@ -53,10 +81,12 @@ export interface ResolvedQaSurfaceConfig {
         readonly welcomeMessage: string;
         readonly placeholder: string;
         readonly logoUrl: string | null;
+        readonly disclaimer: string;
     };
     readonly session: {
         readonly policy: QaSessionPolicy;
         readonly storageKey: string;
+        readonly cwd: string | null;
         readonly workspaceId: string | null;
         readonly fixedSessionId: string | null;
         readonly agentPreset: string | null;
@@ -70,39 +100,150 @@ export interface ResolvedQaSurfaceConfig {
         readonly showStop: boolean;
         readonly showTimestamps: boolean;
         readonly showToolActivity: boolean;
-        readonly showReasoning: false;
+        readonly showReasoning: boolean;
         readonly renderMarkdown: boolean;
         readonly maxContentWidth: number;
+        readonly showSessionList: boolean;
     };
     readonly suggestedQuestions: readonly string[];
     readonly interaction: {
         readonly approvals: "blocked";
         readonly questions: "unsupported";
     };
+    readonly lockdown: {
+        readonly enabled: boolean;
+        readonly enforceFixedAgentPreset: boolean;
+        readonly enforceFixedWorkspace: boolean;
+        readonly enforceFixedModel: boolean;
+        readonly sandboxMode: QaSandboxMode;
+        readonly approvalPolicy: QaApprovalPolicy;
+        readonly permissionPreset: string;
+        readonly allowPermissionChanges: false;
+        readonly allowSlashCommands: false;
+        readonly allowSettingsMutation: false;
+        readonly allowSessionReset: boolean;
+        readonly allowSessionRename: false;
+        readonly allowSessionDelete: false;
+        readonly allowArbitrarySessionOpen: false;
+        readonly toolPolicy: {
+            readonly mode: QaToolPolicyMode;
+            readonly allow: readonly string[];
+        };
+    };
     readonly embedding: {
         readonly frameAncestors: string | null;
     };
 }
+/** Host-attested facts required before the QA composer may become writable. */
+export interface QaLockdownProof {
+    readonly sessionId: string;
+    readonly enabled: boolean;
+    readonly agentPresetMatches: boolean;
+    readonly workspaceMatches: boolean;
+    readonly modelMatches: boolean;
+    readonly sandboxIsReadOnly: boolean;
+    readonly approvalIsNever: boolean;
+    readonly permissionPreset: string;
+    readonly toolPolicyLoaded: boolean;
+    readonly toolAllowList: readonly string[];
+}
 export type QaMessage = {
     readonly id: string;
     readonly role: "user";
     readonly text: string;
     readonly status: "committed";
     readonly timestamp?: number;
+    readonly images?: readonly QaImageView[];
 } | {
     readonly id: string;
     readonly role: "assistant";
     readonly text: string;
     readonly status: "streaming" | "committed" | "failed";
     readonly timestamp?: number;
+    /** Host turn this answer belongs to; groups regenerations into variants. */
+    readonly turn?: number;
+    /** Host-recorded response timing, present on finalized messages only. */
+    readonly stats?: {
+        /** step start → final message. */
+        readonly durationMs: number;
+        /** step start → first token; null when no token delta was recorded. */
+        readonly ttftMs: number | null;
+        /** Estimated from visible text (≈4 chars/token) over the generation window. */
+        readonly tokensPerSecond: number | null;
+    };
 } | {
     readonly id: string;
     readonly role: "system";
     readonly text: string;
     readonly status: "info" | "error";
     readonly timestamp?: number;
+    /** Collapsible settlement row (subagent finished/stopped/failed). */
+    readonly notice?: {
+        readonly title: string;
+        readonly body: string;
+    };
+} | {
+    readonly id: string;
+    readonly role: "work";
+    readonly turn: number;
+    readonly status: "running" | "complete";
+    readonly startedAt?: number;
+    readonly endedAt?: number;
+    readonly items: readonly QaWorkItem[];
+};
+export type QaWorkItem = {
+    readonly id: string;
+    readonly kind: "reasoning" | "progress";
+    readonly text: string;
+    readonly status: "running" | "complete";
+} | {
+    readonly id: string;
+    readonly kind: "tool";
+    readonly name: string;
+    readonly label: string;
+    readonly summary: string;
+    readonly input: string | null;
+    readonly output: string | null;
+    readonly status: "running" | "ok" | "error" | "stopped";
+    /** Durable child id, present on subagent launch calls that started one. */
+    readonly subagentId?: string;
+    readonly startedAt?: number;
+    readonly endedAt?: number;
 };
 export type QaSessionPhase = "idle" | "creating" | "ready" | "running" | "reconnecting" | "blocked" | "error";
+/** One tool-derived source shown in the sources drawer. */
+export interface QaSource {
+    readonly id: string;
+    readonly kind: "web" | "search" | "file";
+    /** URL, filesystem path or search query as the model supplied it. */
+    readonly target: string;
+    readonly title: string;
+    readonly snippet: string;
+    /** The tool's full text output, capped for the detail pane. */
+    readonly output: string;
+}
+/** Raster formats the attachment path accepts (mirrors the host contract). */
+export type QaImageMediaType = "image/png" | "image/jpeg" | "image/webp" | "image/gif";
+/** One image pending in the composer, browser-owned until the prompt lands. */
+export interface QaImageDraft {
+    readonly id: string;
+    readonly mediaType: QaImageMediaType;
+    readonly name: string;
+    /** Canonical base64 of the image bytes, without the data: URL prefix. */
+    readonly data: string;
+    /** Local object URL for the preview thumbnail. */
+    readonly previewUrl: string;
+}
+/** A durable image attached to a sent message. */
+export interface QaImageView {
+    readonly attachmentId: string;
+    readonly mediaType: QaImageMediaType;
+}
+/** A subagent transcript opened read-only from the agents panel. */
+export interface QaSubagentView {
+    readonly id: string;
+    readonly title: string;
+}
 export interface QaSessionState {
     readonly phase: QaSessionPhase;
     readonly sessionId: string | null;
@@ -110,5 +251,11 @@ export interface QaSessionState {
     readonly error: string | null;
     readonly canSend: boolean;
     readonly canStop: boolean;
+    /** Bumped whenever this browser's chat index changes (add/forget). */
+    readonly chatsRevision: number;
+    /** Tool-derived sources of the current chat (web targets and files read). */
+    readonly sources: readonly QaSource[];
+    /** Set while the bound session is a subagent watched from the panel. */
+    readonly viewingSubagent: QaSubagentView | null;
 }
 //# sourceMappingURL=types.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yadsh/dsh-qa-surface",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "description": "A focused end-user QA surface backed by native DeepSeek Harness sessions",
   "repository": {
     "type": "git",
@@ -23,6 +23,14 @@
       "types": "./lib/types/client/index.d.ts",
       "default": "./lib/client.js"
     },
+    "./remote": {
+      "types": "./lib/typert.remote-client.d.ts",
+      "default": "./lib/typert.remote-client.js"
+    },
+    "./typert": {
+      "types": "./lib/typert.host.d.ts",
+      "default": "./lib/typert.host.js"
+    },
     "./types": {
       "types": "./lib/types/types.d.ts",
       "default": "./lib/types.js"
@@ -51,9 +59,10 @@
   "files": [
     "lib/**/*.js",
     "lib/**/*.js.map",
-    "lib/types/**/*.d.ts",
+    "lib/**/*.d.ts",
     "cordis.patch.yml",
     "compatibility.json",
+    "capability-policy.json",
     "README.md",
     "CHANGELOG.md",
     "docs/*.md",
@@ -77,6 +86,8 @@
     "@deepseek-ai/cordis": "^4.0.1",
     "@deepseek-ai/schemastery": "^3.18.1",
     "@deepseek-ai/dsh-api-gateway": ">=0.1.1-rc.2 <0.2.0",
+    "@deepseek-ai/dsh-agent": ">=0.1.1-rc.2 <0.2.0",
+    "@deepseek-ai/dsh-agent-presets": ">=0.1.1-rc.2 <0.2.0",
     "@deepseek-ai/dsh-client-connection": ">=0.1.1-rc.2 <0.2.0",
     "@deepseek-ai/dsh-client-runtime": ">=0.1.1-rc.2 <0.2.0",
     "@deepseek-ai/dsh-client-ui-layout": ">=0.1.1-rc.2 <0.2.0",
@@ -84,16 +95,24 @@
     "@deepseek-ai/dsh-client-ui-slots": ">=0.1.1-rc.2 <0.2.0",
     "@deepseek-ai/dsh-client-ui-theme": ">=0.1.1-rc.2 <0.2.0",
     "@deepseek-ai/dsh-host-webserver": ">=0.1.1-rc.2 <0.2.0",
+    "@deepseek-ai/dsh-permission-presets": ">=0.1.1-rc.2 <0.2.0",
+    "@deepseek-ai/dsh-session": ">=0.1.1-rc.2 <0.2.0",
     "@deepseek-ai/dsh-settings": ">=0.1.1-rc.2 <0.2.0",
+    "@deepseek-ai/dsh-tools": ">=0.1.1-rc.2 <0.2.0",
+    "@deepseek-ai/dsh-typert-protocol": ">=0.1.1-rc.2 <0.2.0",
+    "@deepseek-ai/dsh-workspace": ">=0.1.1-rc.2 <0.2.0",
     "react": "^18.2.0"
   },
   "dependencies": {
+    "zod": "^4.4.3",
     "@yadsh/dsh-plugin-log": "^0.2.1"
   },
   "devDependencies": {
     "@deepseek-ai/cordis": "4.0.1",
     "@deepseek-ai/schemastery": "3.18.1",
     "@deepseek-ai/dsh-api-gateway": "0.1.1-rc.2",
+    "@deepseek-ai/dsh-agent": "0.1.1-rc.2",
+    "@deepseek-ai/dsh-agent-presets": "0.1.1-rc.2",
     "@deepseek-ai/dsh-client-connection": "0.1.1-rc.2",
     "@deepseek-ai/dsh-client-runtime": "0.1.1-rc.2",
     "@deepseek-ai/dsh-client-ui-layout": "0.1.1-rc.2",
@@ -101,7 +120,13 @@
     "@deepseek-ai/dsh-client-ui-slots": "0.1.1-rc.2",
     "@deepseek-ai/dsh-client-ui-theme": "0.1.1-rc.2",
     "@deepseek-ai/dsh-host-webserver": "0.1.1-rc.2",
+    "@deepseek-ai/dsh-permission-presets": "0.1.1-rc.2",
+    "@deepseek-ai/dsh-session": "0.1.1-rc.2",
     "@deepseek-ai/dsh-settings": "0.1.1-rc.2",
+    "@deepseek-ai/dsh-tools": "0.1.1-rc.2",
+    "@deepseek-ai/dsh-typert-generator": "0.1.1-rc.2",
+    "@deepseek-ai/dsh-typert-protocol": "0.1.1-rc.2",
+    "@deepseek-ai/dsh-workspace": "0.1.1-rc.2",
     "@testing-library/react": "^16.3.0",
     "@types/node": "^26.4.0",
     "@types/react": "18.3.28",
@@ -113,6 +138,7 @@
     "tsdown": "^0.22.14",
     "typescript": "^7.0.2",
     "vitest": "^4.1.11",
+    "@yadsh/dsh-plugin-scripts": "^0.0.0",
     "@yadsh/dsh-config": "^0.0.0"
   },
   "publishConfig": {
@@ -121,7 +147,7 @@
   },
   "scripts": {
     "clean": "node -e \"require('node:fs').rmSync('lib', { recursive: true, force: true })\"",
-    "build": "pnpm run clean && tsdown && tsc -p tsconfig.build.json",
+    "build": "pnpm run clean && node scripts/generate-typert.mjs && tsc -p tsconfig.build.json && tsdown",
     "lint": "eslint src tests scripts tsdown.config.ts",
     "format": "prettier --check . --end-of-line auto",
     "format:write": "prettier --write . --end-of-line auto",