@achasoft/dsh-advanced-sidebar 0.1.0 → 0.3.0

package/lib/ui-preview.js

@@ -0,0 +1,352 @@
+import { d as parseHttpUrl, h as resolveWorkspace, m as resolveInside } from "./preview-content-BVUQ5oOR.js";
+import z from "@deepseek-ai/schemastery";
+import { defineTool } from "@deepseek-ai/dsh-tools";
+
+//#region tsbuild/host/ui-preview-tool.js
+/** Cordis plugin name for the model-facing tool. */
+const name = "advanced-sidebar-ui-preview";
+/** The tool registry and the sidebar service both have to be present for this tool to mean anything. */
+const inject = ["tools", "advancedSidebar"];
+/** Schemastery configuration for the tool. */
+const Config = z.object({ commandTimeoutMs: z.number().step(1).min(1e3).max(6e5).default(15e3) });
+/** The action names, as one union the schema and the dispatch both read. */
+const ACTIONS = [
+	"open",
+	"dom",
+	"eval",
+	"console",
+	"click",
+	"type",
+	"reload",
+	"resize",
+	"close"
+];
+/**
+* Largest JSON body this tool will put in a result block.
+*
+* A DOM reading is already capped inside the frame, but a page whose `eval` returns a megabyte of
+* JSON is one expression away; the model is told the value was cut rather than handed a transcript
+* it cannot afford.
+*/
+const RESULT_MAX_CHARS = 96 * 1024;
+/** Compose one text block.
+*
+* The return type is deliberately inferred rather than annotated with the harness's `ContentBlock`:
+* the build's types come from the local harness checkout while the running install has its own
+* copy, and the two copies' branded attachment ids are not identical. An inferred structural
+* `{ type: 'text'; text: string }` satisfies both, which is exactly what this block is.
+*/
+function text(value) {
+	return {
+		type: "text",
+		text: value
+	};
+}
+/**
+* Render a JSON value for a tool result, cut at {@link RESULT_MAX_CHARS}.
+* @param value - the value to serialize.
+* @returns a fenced JSON block.
+*/
+function jsonBlock(value) {
+	let text$1;
+	try {
+		text$1 = JSON.stringify(value, null, 2);
+	} catch (error) {
+		text$1 = JSON.stringify({ unserializable: error instanceof Error ? error.message : String(error) });
+	}
+	return [
+		"```json",
+		text$1.length > RESULT_MAX_CHARS ? `${text$1.slice(0, RESULT_MAX_CHARS)}\n…cut at ${String(RESULT_MAX_CHARS)} characters` : text$1,
+		"```"
+	].join("\n");
+}
+/**
+* Compose the failure sentence for an action that was missing an argument.
+* @param action - the action being run.
+* @param missing - the argument it needs.
+* @returns the model-facing sentence.
+*/
+function requireArg(action, missing) {
+	return `ui_preview "${action}" needs a \`${missing}\` argument`;
+}
+/**
+* Register the model-facing UI preview tool.
+* @param ctx - registrant context carrying the tool registry and the sidebar service.
+* @param config - the deployment's tool configuration.
+*/
+function apply(ctx, config) {
+	const registry = ctx.get("tools");
+	if (registry === void 0) return;
+	registry.register(defineTool({
+		name: "ui_preview",
+		description: "See and drive a UI in the Preview panel: open a page or a workspace file in an iframe that is SAME-ORIGIN with the GUI, then read its DOM, run JavaScript in it, read its console, or click and type into it. Use this to verify a frontend change you just made, to find out why an element is not where it should be, or to drive a flow end to end.\nActions: open (a workspace file path or an http(s) URL), dom (rendered DOM + text + box metrics, optionally under a CSS selector), eval (an expression in the frame, returned as JSON), console (buffered log/warn/error and uncaught errors), click, type (set a value and dispatch input + change), reload, resize (frame viewport), close.\nThe Preview panel must already be open in the session, and a command fails with a clear reason rather than waiting when it is not. A page that is not same-origin (a URL the Host refuses to proxy, or one that redirected off this origin) cannot be inspected: the tool says so instead of returning an empty DOM.",
+		parameters: {
+			action: {
+				type: "string",
+				required: true,
+				enum: ACTIONS,
+				description: "What to do. `open` points the panel at a file or URL; `dom`/`eval`/`console` inspect it; `click`/`type` drive it; `reload`/`resize`/`close` manage the surface."
+			},
+			url: {
+				type: "string",
+				description: "open: an http(s) URL. Use this or `path`, not both."
+			},
+			path: {
+				type: "string",
+				description: "open: a workspace file, absolute or relative to the session workspace."
+			},
+			workspace: {
+				type: "string",
+				description: "The absolute session workspace directory. Defaults to the session's own cwd."
+			},
+			waitMs: {
+				type: "integer",
+				description: "open: how long the panel may take to mount and load before giving up. Defaults to the configured command timeout."
+			},
+			selector: {
+				type: "string",
+				description: "dom/click/type: a CSS selector. Omitted for `dom` means the whole document."
+			},
+			expression: {
+				type: "string",
+				description: "eval: a JavaScript expression or statement, run in the frame."
+			},
+			cursor: {
+				type: "integer",
+				description: "console: a cursor from a previous call; omitted starts at the oldest retained line."
+			},
+			text: {
+				type: "string",
+				description: "type: the value to set before dispatching input and change."
+			},
+			key: {
+				type: "string",
+				description: "type: an optional key name to dispatch after the value is set, e.g. \"Enter\"."
+			},
+			width: {
+				type: "integer",
+				description: "resize: frame viewport width in CSS pixels."
+			},
+			height: {
+				type: "integer",
+				description: "resize: frame viewport height in CSS pixels."
+			}
+		},
+		output: {
+			schema: {
+				type: "object",
+				additionalProperties: false,
+				properties: {
+					action: {
+						type: "string",
+						required: true,
+						enum: ACTIONS
+					},
+					ok: {
+						type: "boolean",
+						required: true
+					},
+					summary: {
+						type: "string",
+						required: true,
+						description: "One line describing what happened."
+					},
+					detail: {
+						type: "string",
+						description: "A JSON body: the DOM reading, the evaluated value, the console entries, or the frame state."
+					}
+				}
+			},
+			render: (_args, value) => [text(value.summary), ...value.detail === void 0 ? [] : [text(value.detail)]]
+		},
+		isConcurrencySafe: () => false,
+		async execute(args, exec) {
+			const service = ctx.advancedSidebar;
+			const action = args.action;
+			const sessionId = exec.agent?.session.id ?? "";
+			const workspace = args.workspace ?? exec.agent?.session.header.cwd;
+			switch (action) {
+				case "open": {
+					const waitMs = args.waitMs ?? config.commandTimeoutMs;
+					if (args.url !== void 0 && args.url !== "") {
+						const parsed = parseHttpUrl(args.url);
+						if (!parsed.ok) return {
+							action,
+							ok: false,
+							summary: parsed.message
+						};
+						const outcome$1 = await service.openUrl(sessionId, parsed.url.href, waitMs);
+						return outcome$1.ok ? {
+							action,
+							ok: true,
+							summary: outcome$1.message,
+							detail: jsonBlock(outcome$1.detail)
+						} : {
+							action,
+							ok: false,
+							summary: outcome$1.message
+						};
+					}
+					if (args.path === void 0 || args.path === "") return {
+						action,
+						ok: false,
+						summary: `${requireArg(action, "path")} (or a \`url\` to open)`
+					};
+					if (workspace === void 0 || workspace === "") return {
+						action,
+						ok: false,
+						summary: "ui_preview needs a workspace: this call has no session working directory, so pass `workspace` with the absolute session directory"
+					};
+					const root = await resolveWorkspace(ctx, workspace, exec.signal);
+					if (!root.ok) return {
+						action,
+						ok: false,
+						summary: root.rejection.message
+					};
+					const absolute = args.path.startsWith("/") ? args.path : `${root.value.processPath.replace(/\/$/u, "")}/${args.path}`;
+					const inside = await resolveInside(ctx, root.value, absolute, exec.signal);
+					if (!inside.ok) return {
+						action,
+						ok: false,
+						summary: inside.rejection.message
+					};
+					const info = await service.describeFile({
+						workspacePath: root.value.processPath,
+						path: inside.value.processPath
+					}, exec.signal);
+					if (!info.ok) return {
+						action,
+						ok: false,
+						summary: info.message
+					};
+					const outcome = await service.openFile({
+						sessionId,
+						workspacePath: root.value.processPath,
+						filePath: inside.value.processPath,
+						kind: info.kind,
+						waitMs
+					});
+					return outcome.ok ? {
+						action,
+						ok: true,
+						summary: outcome.message,
+						detail: jsonBlock({
+							path: inside.value.processPath,
+							kind: info.kind,
+							contentType: info.contentType,
+							bytes: info.bytes,
+							sameOrigin: true
+						})
+					} : {
+						action,
+						ok: false,
+						summary: outcome.message
+					};
+				}
+				case "dom":
+				case "eval":
+				case "console":
+				case "click":
+				case "type":
+				case "reload":
+				case "resize":
+				case "close": {
+					if (action === "eval" && (args.expression === void 0 || args.expression === "")) return {
+						action,
+						ok: false,
+						summary: requireArg(action, "expression")
+					};
+					if ((action === "click" || action === "type") && (args.selector === void 0 || args.selector === "")) return {
+						action,
+						ok: false,
+						summary: requireArg(action, "selector")
+					};
+					if (action === "type" && args.text === void 0) return {
+						action,
+						ok: false,
+						summary: requireArg(action, "text")
+					};
+					if (action === "resize" && (args.width === void 0 || args.height === void 0)) return {
+						action,
+						ok: false,
+						summary: "ui_preview \"resize\" needs both a `width` and a `height`"
+					};
+					const body = {
+						kind: action === "type" ? "input" : action,
+						...args.selector === void 0 ? {} : { selector: args.selector },
+						...args.expression === void 0 ? {} : { expression: args.expression },
+						...args.cursor === void 0 ? {} : { cursor: args.cursor },
+						...args.text === void 0 ? {} : { text: args.text },
+						...args.key === void 0 ? {} : { key: args.key },
+						...args.width === void 0 ? {} : { width: args.width },
+						...args.height === void 0 ? {} : { height: args.height }
+					};
+					const outcome = await service.queueCommand(sessionId, body);
+					if (!outcome.ok) return {
+						action,
+						ok: false,
+						summary: outcome.message
+					};
+					return describe(action, outcome.result);
+				}
+				default: return {
+					action,
+					ok: false,
+					summary: `unknown action ${String(action)}`
+				};
+			}
+		},
+		presentCall: (args) => ({
+			card: "generic",
+			title: args.action === "open" ? `Preview ${args.url ?? args.path ?? ""}` : `Preview ${args.action}${args.selector === void 0 ? "" : ` ${args.selector}`}`,
+			kind: "other",
+			rawInput: args
+		})
+	}));
+}
+/**
+* Phrase one command result for the model.
+* @param action - the action that produced it.
+* @param result - the panel's answer.
+* @returns the tool's own answer.
+*/
+function describe(action, result) {
+	if (result.kind === "dom") {
+		const lines = result.nodes.map((node) => `${"  ".repeat(node.depth)}<${node.tag}${node.selector === "" ? "" : ` ${node.selector}`}> ${node.display} ${String(Math.round(node.box.width))}×${String(Math.round(node.box.height))}${node.text === "" ? "" : ` — ${JSON.stringify(node.text.slice(0, 120))}`}`);
+		return {
+			action,
+			ok: true,
+			summary: `${String(result.nodes.length)} element(s) under ${result.selector === "" ? "the document" : JSON.stringify(result.selector)} in a ${String(result.viewport.width)}×${String(result.viewport.height)} viewport${result.truncated ? " (cut short)" : ""}.`,
+			detail: [
+				lines.join("\n"),
+				"",
+				jsonBlock(result)
+			].join("\n")
+		};
+	}
+	if (result.kind === "eval") return {
+		action,
+		ok: true,
+		summary: `The expression returned ${result.note === void 0 ? "" : `${result.note}: `}${result.value.slice(0, 400)}`,
+		detail: jsonBlock(result)
+	};
+	if (result.kind === "console") return {
+		action,
+		ok: true,
+		summary: result.entries.length === 0 ? "No console output since that cursor." : `${String(result.entries.length)} console entr(ies); cursor ${String(result.cursor)}${result.lossy ? " (earlier lines fell out of the retained window)" : ""}.`,
+		...result.entries.length === 0 ? {} : { detail: [
+			result.entries.map((entry) => `[${entry.level}] ${entry.text}`).join("\n"),
+			"",
+			jsonBlock(result)
+		].join("\n") }
+	};
+	return {
+		action,
+		ok: true,
+		summary: result.detail,
+		detail: jsonBlock(result)
+	};
+}
+
+//#endregion
+export { Config, apply, inject, name };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@achasoft/dsh-advanced-sidebar",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "Advanced sidebar operations for the DeepSeek Harness Web Client: git changes, multi-session terminals, a file browser, a dev-server preview, background tasks, Open in, Archive and Delete, in a resizable dock beside the conversation",
   "license": "MIT",
   "type": "module",
@@ -21,6 +21,10 @@
       "types": "./types/host/index.d.ts",
       "default": "./lib/host.js"
     },
+    "./ui-preview": {
+      "types": "./types/ui-preview.d.ts",
+      "default": "./lib/ui-preview.js"
+    },
     "./client": {
       "default": "./lib/client.js"
     },
@@ -66,8 +70,8 @@
     "@deepseek-ai/dsh-llm": "*",
     "@deepseek-ai/dsh-session": "*",
     "@deepseek-ai/dsh-session-persistence": "*",
-    "@deepseek-ai/dsh-settings": "*",
     "@deepseek-ai/dsh-subprocess": "*",
+    "@deepseek-ai/dsh-tools": "*",
     "@deepseek-ai/dsh-typert-protocol": "*",
     "@deepseek-ai/dsh-workspace": "*",
     "@deepseek-ai/schemastery": "*"
@@ -93,12 +97,14 @@
     "@deepseek-ai/dsh-client-ui-slots": "link:../../deepseek-harness/packages/client/ui-slots",
     "@deepseek-ai/dsh-client-ui-theme": "link:../../deepseek-harness/packages/client/ui-theme",
     "@deepseek-ai/dsh-fs": "link:../../deepseek-harness/packages/fs/fs",
+    "@deepseek-ai/dsh-host-webserver": "link:../../deepseek-harness/packages/host/webserver",
     "@deepseek-ai/dsh-jobs": "link:../../deepseek-harness/packages/jobs/jobs",
     "@deepseek-ai/dsh-llm": "link:../../deepseek-harness/packages/llm/llm",
     "@deepseek-ai/dsh-session": "link:../../deepseek-harness/packages/core/session",
     "@deepseek-ai/dsh-session-persistence": "link:../../deepseek-harness/packages/session/session-persistence",
     "@deepseek-ai/dsh-settings": "link:../../deepseek-harness/packages/settings/settings",
     "@deepseek-ai/dsh-subprocess": "link:../../deepseek-harness/packages/subprocess/subprocess",
+    "@deepseek-ai/dsh-tools": "link:../../deepseek-harness/packages/core/tools",
     "@deepseek-ai/dsh-typert-protocol": "link:../../deepseek-harness/packages/typert/protocol",
     "@deepseek-ai/dsh-workspace": "link:../../deepseek-harness/packages/workspace/workspace",
     "@deepseek-ai/schemastery": "link:../../deepseek-harness/vendor/schemastery",

package/types/client/ActionMenu.d.ts

@@ -10,6 +10,13 @@
 import type { AdvancedSidebarSettings, AdvancedSidebarView } from '../host/types.ts';
 import type { MenuInjected, Translate } from './contract.ts';
 import type { OperationTarget, PanelKind } from './controller.ts';
+/** What the menu needs to know about the harness's session-log export for this session. */
+export interface LogDownloadRow {
+    /** Whether this plugin is the download surface; false leaves the entry out entirely. */
+    active: boolean;
+    /** Whether this session's export is in flight, which disables the entry as the harness's did. */
+    busy: boolean;
+}
 /** Everything the menu renders from, plus the callbacks it fires. */
 export interface ActionMenuProps {
     /** The session and directory every entry acts on; absent disables everything but the trigger. */
@@ -21,11 +28,19 @@ export interface ActionMenuProps {
     /** The namespace translator. */
     t: Translate;
     /** Business callbacks, minus the reactive sources the seat binds itself. */
-    actions: Pick<MenuInjected, 'openPanel' | 'openIn' | 'openWindow' | 'archive' | 'requestDelete'>;
+    actions: Pick<MenuInjected, 'openPanel' | 'openIn' | 'openWindow' | 'archive' | 'requestDelete' | 'downloadLog'>;
     /** Ask the Host for a fresh capability view; called each time the menu opens. */
     refresh: () => void;
     /** Which panel the dock is showing, so the open entry reads as the current one. */
     openPanel: PanelKind | undefined;
+    /** The session-log export entry's state. */
+    logDownload: LogDownloadRow;
+    /**
+     * Offer Download session log and nothing else. Set when the settings section switched the menu
+     * out of the header: this plugin still shadows the harness's own download button, so it stands in
+     * for exactly that button rather than taking the verb away with the menu.
+     */
+    logsOnly: boolean;
 }
 /**
  * The trigger plus its menu.

package/types/client/LogDownloadDialog.d.ts

@@ -0,0 +1,24 @@
+/**
+ * The entry that shadows the harness's session-log download button.
+ *
+ * It occupies the `session-log-download` cell of the header's utilities row one priority ahead of
+ * the harness, which is what removes the second "⋯" (see `log-download.ts` for why shadowing was
+ * chosen). What it renders in that cell is no button at all — the verb now lives in this plugin's
+ * menu — only the export dialog the shadowed entry used to render beside its button.
+ *
+ * The dialog is a faithful re-rendering of the harness's `SessionLogDownloadDialog` (0.1.5-rc.2): the
+ * same `Modal` and `Button` from `@deepseek-ai/dsh-client-ui-primitives`, the same status-to-copy
+ * mapping, bound to the same controller state. It is not this plugin's own kit `Dialog` on purpose:
+ * the dialog also opens after a successful `/export` command, where it has always been the
+ * harness's, and a person should not see it change shape because a plugin is installed.
+ * @module @achasoft/dsh-advanced-sidebar/client/LogDownloadDialog
+ */
+import type { LogDownloadSeatProps } from './contract.ts';
+/**
+ * The export dialog for the session this header belongs to.
+ * @param props - the session, the bridged export state, the dismiss callback, and the translator.
+ * @returns the modal portal while this session's dialog is open; nothing otherwise, which leaves no
+ * box in the header row.
+ * @see {@link LogDownloadSeatProps}
+ */
+export declare function LogDownloadDialog(props: LogDownloadSeatProps): import("react").JSX.Element | null;

package/types/client/contract.d.ts

@@ -9,8 +9,9 @@
  */
 import type { SettingsScope } from '@deepseek-ai/dsh-client-runtime/client';
 import type { InjectFace, PropsLocale, PropsRuntime, TranslateNS } from '@deepseek-ai/dsh-client-ui-slots';
-import type { AdvancedSidebarSettings, AdvancedSidebarView, DeleteSessionResult, GitCommitMessageResult, GitCommitResult, GitDiffRequest, GitDiffResult, GitPushResult, GitStageResult, GitStatusResult, ListEntriesResult, PreviewListResult, PreviewLogsResult, PreviewStartResult, PreviewStopResult, ReadFileResult, TaskKillResult, TaskOutputResult, TerminalAckResult, TerminalOpenResult, TerminalReadResult } from '../host/types.ts';
+import type { AdvancedSidebarSettings, AdvancedSidebarView, DeleteSessionResult, GitCommitMessageResult, GitCommitResult, GitDiffRequest, GitDiffResult, GitPushResult, GitStageResult, GitStatusResult, ListEntriesResult, PreviewFileInfoResult, PreviewListResult, PreviewLogsResult, PreviewPollRequest, PreviewPollResult, PreviewResultAck, PreviewResultRequest, PreviewReleaseResult, PreviewStartResult, PreviewStopResult, ReadFileResult, TaskKillResult, TaskOutputResult, TerminalAckResult, TerminalOpenResult, TerminalReadResult } from '../host/types.ts';
 import type { OperationTarget, PanelController, PanelKind } from './controller.ts';
+import type { LogDownloadBridge } from './log-download.ts';
 import type { AdvancedSidebarKey } from './locales.ts';
 declare module '@deepseek-ai/dsh-client-ui-slots' {
     interface LocaleNamespaceMap {
@@ -37,6 +38,11 @@ export interface MenuInjected {
         sidebar: PanelController;
         /** The bound `advanced-sidebar` settings scope, which decides the menu's entries. */
         settings: SettingsScope<AdvancedSidebarSettings>;
+        /**
+         * The harness's session-log export, bridged: inactive while its package is absent or its header
+         * button is not being shadowed, which is when the menu offers no Download entry.
+         */
+        logDownload: LogDownloadBridge;
     };
     /**
      * Read the Host's capability view so an entry can be disabled with a reason.
@@ -59,6 +65,12 @@ export interface MenuInjected {
     openIn: (targetId: string, path: string) => Promise<void>;
     /** Open the Web Client in a second browser window. */
     openWindow: () => void;
+    /**
+     * Start the harness's session-log export for one session; its progress dialog is the shadowing
+     * entry's, not the menu's.
+     * @param sessionId - the session whose log, sub-sessions and attachments are exported.
+     */
+    downloadLog: (sessionId: string) => void;
     /**
      * Archive one session.
      * @param target - the session to hide.
@@ -74,6 +86,21 @@ export interface MenuInjected {
 }
 /** Full props of the session-header trigger. */
 export type HeaderMenuProps = PropsRuntime<'conversation.session.header.utilities'> & PropsLocale<'advancedSidebar'> & InjectFace<MenuInjected>;
+/** Everything the entry shadowing the harness's download button needs. */
+export interface LogDownloadSeatInjected {
+    /** Registrant-private reactive sources the renderer binds to `use<Name>` hooks. */
+    hooks: {
+        /** The bridged export state; the dialog renders only while it is active. */
+        logDownload: LogDownloadBridge;
+    };
+    /**
+     * Close one session's dialog without cancelling its export.
+     * @param sessionId - the session whose dialog closes.
+     */
+    dismiss: (sessionId: string) => void;
+}
+/** Full props of the entry shadowing the harness's download button. */
+export type LogDownloadSeatProps = PropsRuntime<'conversation.session.header.utilities'> & PropsLocale<'advancedSidebar'> & InjectFace<LogDownloadSeatInjected>;
 /** Everything the dock and its confirmation dialog need. */
 export interface PanelHostInjected {
     /** Registrant-private reactive sources the renderer binds to `use<Name>` hooks. */
@@ -217,6 +244,35 @@ export interface PanelHostInjected {
      * @returns the delta and the state, or a classified failure.
      */
     previewLogs: (serverId: string, fromOffset: number) => Promise<PreviewLogsResult>;
+    /**
+     * Describe one workspace file for the Preview panel's Files mode.
+     * @param workspacePath - the workspace the path must stay inside.
+     * @param path - the file.
+     * @param signal - cancellation for the reads.
+     * @returns the file's kind, size, same-origin URL, and change token.
+     */
+    previewFileInfo: (workspacePath: string, path: string, signal?: AbortSignal) => Promise<PreviewFileInfoResult>;
+    /**
+     * Register this panel and take whatever the agent queued for it.
+     *
+     * This is both the poll and the heartbeat: the Host trusts a panel only while it keeps calling,
+     * which is what turns a closed tab into a clear tool failure instead of a wait.
+     * @param request - which panel, where it is, and whether a preview is rendered.
+     * @returns the work to do, or a classified failure.
+     */
+    previewPoll: (request: PreviewPollRequest) => Promise<PreviewPollResult>;
+    /**
+     * Report what one agent command did.
+     * @param request - the panel, the command id, and the outcome.
+     * @returns settlement.
+     */
+    previewResult: (request: PreviewResultRequest) => Promise<PreviewResultAck>;
+    /**
+     * Say that this panel is gone, so its queued work is dropped.
+     * @param clientId - this panel's id.
+     * @returns settlement.
+     */
+    previewRelease: (clientId: string) => Promise<PreviewReleaseResult>;
     /**
      * Open one path with the Host operating system's default application.
      * @param path - the absolute path.

package/types/client/index.d.ts

@@ -2,7 +2,8 @@
  * Advanced sidebar plugin, browser half: three registrations over one Host endpoint and one shared
  * piece of state.
  *
- * - `conversation.session.header.utilities` — the menu on the open session.
+ * - `conversation.session.header.utilities` — the menu on the open session, and, in the same row,
+ *   the entry shadowing the harness's own session-log download button, whose verb the menu absorbs.
  * - `shell.overlay` — the resizable dock holding whichever panel is open, plus the Delete
  *   confirmation.
  * - `settings.plugin.item` — the card on the plugin-configuration tab, keyed by the namespace.
@@ -18,7 +19,8 @@
  */
 import type { ClientContext } from '@deepseek-ai/dsh-client-runtime/client';
 export type { AdvancedSidebarKey } from './locales.ts';
-export type { HeaderMenuProps, MenuInjected, PanelHostInjected, PanelHostProps, SettingsCardInjected, SettingsCardProps, Translate, } from './contract.ts';
+export type { HeaderMenuProps, LogDownloadSeatInjected, LogDownloadSeatProps, MenuInjected, PanelHostInjected, PanelHostProps, SettingsCardInjected, SettingsCardProps, Translate, } from './contract.ts';
+export type { LogDownloadEntry, LogDownloadState, LogDownloadView } from './log-download.ts';
 export type { OperationTarget, PanelKind, SidebarState, TerminalGroup, TerminalTab, } from './controller.ts';
 /**
  * Required services of the OUTER plugin: locale and the Remote mount point.