@achasoft/dsh-advanced-sidebar 0.1.0

package/package.json

@@ -0,0 +1,136 @@
+{
+  "name": "@achasoft/dsh-advanced-sidebar",
+  "version": "0.1.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",
+  "main": "lib/index.js",
+  "files": [
+    "lib",
+    "types",
+    "cordis.patch.yml",
+    "README.md",
+    "LICENSE"
+  ],
+  "exports": {
+    ".": {
+      "types": "./types/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./host": {
+      "types": "./types/host/index.d.ts",
+      "default": "./lib/host.js"
+    },
+    "./client": {
+      "default": "./lib/client.js"
+    },
+    "./typert": {
+      "default": "./lib/typert.host.js"
+    },
+    "./remote": {
+      "default": "./lib/remote.js"
+    },
+    "./cordis.patch.yml": "./cordis.patch.yml",
+    "./package.json": "./package.json"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web",
+      "inject": [
+        "@deepseek-ai/dsh-api-remotes",
+        "@deepseek-ai/dsh-client-locale",
+        "@deepseek-ai/dsh-client-ui-conversation",
+        "@deepseek-ai/dsh-client-ui-layout",
+        "@deepseek-ai/dsh-client-ui-settings",
+        "@deepseek-ai/dsh-client-ui-settings-plugins"
+      ]
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json && tsdown",
+    "prepare": "tsc -p tsconfig.build.json && tsdown",
+    "typecheck": "tsc --noEmit",
+    "test": "node scripts/check-typert.mjs && vitest run",
+    "check:typert": "node scripts/check-typert.mjs",
+    "regen:typert": "node scripts/emit-typert.mjs"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "*",
+    "@deepseek-ai/dsh-agent": "*",
+    "@deepseek-ai/dsh-agent-default-model": "*",
+    "@deepseek-ai/dsh-fs": "*",
+    "@deepseek-ai/dsh-jobs": "*",
+    "@deepseek-ai/dsh-llm": "*",
+    "@deepseek-ai/dsh-session": "*",
+    "@deepseek-ai/dsh-session-persistence": "*",
+    "@deepseek-ai/dsh-settings": "*",
+    "@deepseek-ai/dsh-subprocess": "*",
+    "@deepseek-ai/dsh-typert-protocol": "*",
+    "@deepseek-ai/dsh-workspace": "*",
+    "@deepseek-ai/schemastery": "*"
+  },
+  "dependencies": {
+    "@xterm/addon-fit": "^0.11.0",
+    "@xterm/xterm": "^6.0.0",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "link:../../deepseek-harness/vendor/cordis",
+    "@deepseek-ai/dsh-agent": "link:../../deepseek-harness/packages/core/agent",
+    "@deepseek-ai/dsh-agent-default-model": "link:../../deepseek-harness/packages/core/agent-default-model",
+    "@deepseek-ai/dsh-api-remotes": "link:../../deepseek-harness/packages/api/remotes",
+    "@deepseek-ai/dsh-client-locale": "link:../../deepseek-harness/packages/client/locale",
+    "@deepseek-ai/dsh-client-runtime": "link:../../deepseek-harness/packages/client/runtime",
+    "@deepseek-ai/dsh-client-ui-conversation": "link:../../deepseek-harness/packages/client/ui-conversation",
+    "@deepseek-ai/dsh-client-ui-layout": "link:../../deepseek-harness/packages/client/ui-layout",
+    "@deepseek-ai/dsh-client-ui-primitives": "link:../../deepseek-harness/packages/client/ui-primitives",
+    "@deepseek-ai/dsh-client-ui-settings": "link:../../deepseek-harness/packages/client/ui-settings",
+    "@deepseek-ai/dsh-client-ui-settings-plugins": "link:../../deepseek-harness/packages/client/ui-settings-plugins",
+    "@deepseek-ai/dsh-client-ui-sidebar": "link:../../deepseek-harness/packages/client/ui-sidebar",
+    "@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-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-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",
+    "@types/node": "^22.20.1",
+    "@types/react": "~18.3.1",
+    "@types/react-dom": "^18.3.7",
+    "lightningcss": "^1.30.1",
+    "react": "^18.2.0",
+    "tsdown": "^0.15.6",
+    "typescript": "^5.9.2",
+    "vitest": "^3.2.7"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/navid-kianfar/dsh-advanced-sidebar.git"
+  },
+  "keywords": [
+    "deepseek-harness",
+    "dsh",
+    "dsh-plugin",
+    "sidebar",
+    "git",
+    "terminal",
+    "file-browser",
+    "background-tasks",
+    "cordis"
+  ],
+  "types": "./types/index.d.ts",
+  "engines": {
+    "node": "^22.19 || >=24"
+  }
+}

package/types/client/ActionMenu.d.ts

@@ -0,0 +1,36 @@
+/**
+ * The advanced-operations menu itself, in the session header.
+ *
+ * Entries are built from two independent facts: what the settings section switched on, and what the
+ * Host reported it can serve. A switched-off entry is absent; an entry the Host cannot serve is
+ * present but disabled and carries the reason beside its label, because a person who configured an
+ * editor and sees no row cannot tell a typo from a feature that does not exist.
+ * @module @achasoft/dsh-advanced-sidebar/client/ActionMenu
+ */
+import type { AdvancedSidebarSettings, AdvancedSidebarView } from '../host/types.ts';
+import type { MenuInjected, Translate } from './contract.ts';
+import type { OperationTarget, PanelKind } from './controller.ts';
+/** 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. */
+    target: OperationTarget | undefined;
+    /** The resolved settings section; absent while the scope is still loading. */
+    settings: AdvancedSidebarSettings | undefined;
+    /** The Host capability view; absent until the first probe answers. */
+    view: AdvancedSidebarView | undefined;
+    /** The namespace translator. */
+    t: Translate;
+    /** Business callbacks, minus the reactive sources the seat binds itself. */
+    actions: Pick<MenuInjected, 'openPanel' | 'openIn' | 'openWindow' | 'archive' | 'requestDelete'>;
+    /** 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 trigger plus its menu.
+ * @param props - the target, settings, capability view, translator, and callbacks.
+ * @returns the menu element, or null when the settings section leaves it with no entries.
+ * @see {@link ActionMenuProps}
+ */
+export declare function ActionMenu(props: ActionMenuProps): import("react").JSX.Element | null;

package/types/client/Glyphs.d.ts

@@ -0,0 +1,49 @@
+/**
+ * The glyphs this plugin draws itself, because the client's icon set has no member for them.
+ * Each is a 16×16 outline on `currentColor` at the icon family's stroke weight, so a menu mixing
+ * these with set icons reads as one row of icons.
+ * @module @achasoft/dsh-advanced-sidebar/client/Glyphs
+ */
+/** Props every glyph accepts; `size` overrides the 16px default for a denser row. */
+export interface GlyphProps {
+    /** Edge length in pixels. */
+    size?: number;
+    /** Optional class, for a seat that colors or spaces its icons. */
+    className?: string;
+}
+/**
+ * A page with a folded corner: one file.
+ * @param props - size and class overrides.
+ * @returns the glyph element.
+ */
+export declare function FileGlyph({ size, className }: GlyphProps): import("react").JSX.Element;
+/**
+ * A window with a prompt caret: a terminal.
+ * @param props - size and class overrides.
+ * @returns the glyph element.
+ */
+export declare function TerminalGlyph({ size, className }: GlyphProps): import("react").JSX.Element;
+/**
+ * Two file cards with a plus and a minus: changed files.
+ * @param props - size and class overrides.
+ * @returns the glyph element.
+ */
+export declare function ChangesGlyph({ size, className }: GlyphProps): import("react").JSX.Element;
+/**
+ * A browser window with a play mark: a running application.
+ * @param props - size and class overrides.
+ * @returns the glyph element.
+ */
+export declare function PreviewGlyph({ size, className }: GlyphProps): import("react").JSX.Element;
+/**
+ * A browser window pushed out of a frame: open somewhere else.
+ * @param props - size and class overrides.
+ * @returns the glyph element.
+ */
+export declare function ExternalGlyph({ size, className }: GlyphProps): import("react").JSX.Element;
+/**
+ * An arrow leaving a branch line: a push.
+ * @param props - size and class overrides.
+ * @returns the glyph element.
+ */
+export declare function PushGlyph({ size, className }: GlyphProps): import("react").JSX.Element;

package/types/client/PanelHost.d.ts

@@ -0,0 +1,24 @@
+/**
+ * The dock: a resizable column on the right of the frame holding whichever panel is open, plus the
+ * notice line and the Delete confirmation.
+ *
+ * It was a floating card. It is now a real column — it reserves its own width on the app frame, so
+ * the conversation shrinks beside it instead of disappearing under it, and it carries a drag handle
+ * on its left edge like the frame's own two columns. The reservation is a padding on the frame
+ * element and a matching shift of the frame's details handle, both keyed on one custom property
+ * this component sets: `shell.overlay` is the only additive frame-wide seat a plugin has, and its
+ * layer is drawn above the columns rather than between them.
+ *
+ * Below a frame narrow enough that pushing would leave no conversation, the dock floats over it
+ * instead. That is the same concession every editor makes at that width, and it is derived from the
+ * frame's measured box rather than from a media query, because the frame is not the window.
+ * @module @achasoft/dsh-advanced-sidebar/client/PanelHost
+ */
+import type { PanelHostProps } from './contract.ts';
+/**
+ * The dock, the notice, and the confirmation dialog.
+ * @param props - the standard kit plus this plugin's face.
+ * @returns the overlay tree, or null while nothing is open.
+ * @see {@link PanelHostProps}
+ */
+export declare function PanelHost(props: PanelHostProps): import("react").JSX.Element;

package/types/client/Seats.d.ts

@@ -0,0 +1,16 @@
+/**
+ * The menu seat: the session header's utilities row.
+ *
+ * There was a second seat at the sidebar foot. It was withdrawn — the same menu in two places gave
+ * the column an action whose target was whatever session happened to be current, which is not what
+ * a column of sessions reads as; the header's menu acts on the session it sits in.
+ * @module @achasoft/dsh-advanced-sidebar/client/Seats
+ */
+import type { HeaderMenuProps } from './contract.ts';
+/**
+ * The session header's trigger. Session-scoped, so the framework supplies the session id.
+ * @param props - the standard kit for a session seat plus this plugin's face.
+ * @returns the trigger and its menu, or null while the settings section switches it off.
+ * @see {@link HeaderMenuProps}
+ */
+export declare function HeaderMenu(props: HeaderMenuProps): import("react").JSX.Element | null;

package/types/client/SettingsCard.d.ts

@@ -0,0 +1,22 @@
+/**
+ * The advanced-sidebar card on the plugin-configuration tab.
+ *
+ * It reproduces the configuration section's own chrome — an `<li>` disclosure card, and fields laid
+ * out label / control / hint — because it cannot import those components: value-importing across a
+ * plugin boundary fails the client bundle-purity gate. The controls themselves come from this
+ * package's own shadcn-vocabulary kit, so the card matches the panels rather than the browser's
+ * default form widgets.
+ *
+ * There is no save or discard. Every control writes immediately through the bound settings scope,
+ * which owns revision fencing, so the card carries no staged form whose unsaved state would need
+ * reporting.
+ * @module @achasoft/dsh-advanced-sidebar/client/SettingsCard
+ */
+import type { SettingsCardProps } from './contract.ts';
+/**
+ * The card, its four groups of fields, and the Open in roster.
+ * @param props - the standard kit plus this plugin's face.
+ * @returns the card element.
+ * @see {@link SettingsCardProps}
+ */
+export declare function SettingsCard(props: SettingsCardProps): import("react").JSX.Element;

package/types/client/contract.d.ts

@@ -0,0 +1,358 @@
+/**
+ * The registrant-side contracts of this plugin's four slot entries: what each component is handed,
+ * and the props type it composes from the framework's shares.
+ *
+ * Each face is the whole business surface of one seat. Components never reach a cordis service —
+ * the `apply` closes over `ctx` and hands plain callbacks down, which is what lets every one of
+ * these render in a test with no context at all.
+ * @module @achasoft/dsh-advanced-sidebar/client/contract
+ */
+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 { OperationTarget, PanelController, PanelKind } from './controller.ts';
+import type { AdvancedSidebarKey } from './locales.ts';
+declare module '@deepseek-ai/dsh-client-ui-slots' {
+    interface LocaleNamespaceMap {
+        /** Copy of the session menu, the dock's five panels, the delete dialog, and the settings card. */
+        advancedSidebar: AdvancedSidebarKey;
+    }
+}
+/**
+ * This package's translator, declared once so every component types its `t` seat from the same
+ * place as the framework-synthesized one.
+ */
+export type Translate = TranslateNS<'advancedSidebar'>;
+/** The dictionary namespace this plugin owns; also its settings namespace's camelCase twin. */
+export declare const LOCALE_NS = "advancedSidebar";
+/** The settings namespace the Host section is registered under (kebab-case, as that grammar requires). */
+export declare const SETTINGS_NS = "advanced-sidebar";
+/** The Remote namespace, read as `ctx.remote.advancedSidebar.…`. */
+export declare const REMOTE_NS = "advancedSidebar";
+/** Everything the session header's menu seat needs. */
+export interface MenuInjected {
+    /** Registrant-private reactive sources the renderer binds to `use<Name>` hooks. */
+    hooks: {
+        /** Cross-registration panel state; the menu writes it and the dock reads it. */
+        sidebar: PanelController;
+        /** The bound `advanced-sidebar` settings scope, which decides the menu's entries. */
+        settings: SettingsScope<AdvancedSidebarSettings>;
+    };
+    /**
+     * Read the Host's capability view so an entry can be disabled with a reason.
+     * @param signal - cancellation for the probe.
+     * @returns the capability view.
+     */
+    describe: (signal?: AbortSignal) => Promise<AdvancedSidebarView>;
+    /**
+     * Show one panel in the dock.
+     * @param panel - which panel.
+     * @param target - the session and directory it acts on.
+     */
+    openPanel: (panel: PanelKind, target: OperationTarget) => void;
+    /**
+     * Hand one path to an Open in target.
+     * @param targetId - the target's id.
+     * @param path - the absolute Host path.
+     * @returns after the launch settled; a failure surfaces as a notice.
+     */
+    openIn: (targetId: string, path: string) => Promise<void>;
+    /** Open the Web Client in a second browser window. */
+    openWindow: () => void;
+    /**
+     * Archive one session.
+     * @param target - the session to hide.
+     * @returns after the registry committed; a failure surfaces as a notice.
+     */
+    archive: (target: OperationTarget) => Promise<void>;
+    /**
+     * Begin Delete: ask the Host what it would do, then confirm or commit per the settings.
+     * @param target - the session to delete.
+     * @returns after the confirmation opened, or after an unconfirmed delete committed.
+     */
+    requestDelete: (target: OperationTarget) => Promise<void>;
+}
+/** Full props of the session-header trigger. */
+export type HeaderMenuProps = PropsRuntime<'conversation.session.header.utilities'> & PropsLocale<'advancedSidebar'> & InjectFace<MenuInjected>;
+/** Everything the dock and its confirmation dialog need. */
+export interface PanelHostInjected {
+    /** Registrant-private reactive sources the renderer binds to `use<Name>` hooks. */
+    hooks: {
+        /** Cross-registration panel state; the dock reads it and its own controls write it. */
+        sidebar: PanelController;
+        /** The bound settings scope, which decides the dock's width and which verbs it offers. */
+        settings: SettingsScope<AdvancedSidebarSettings>;
+    };
+    /**
+     * Read the Host's capability view for the dock's own gating.
+     * @param signal - cancellation for the probe.
+     * @returns the capability view.
+     */
+    describe: (signal?: AbortSignal) => Promise<AdvancedSidebarView>;
+    /**
+     * Read one workspace's git status.
+     * @param workspacePath - the directory to read.
+     * @param signal - cancellation for the reading.
+     * @returns the reading, or a classified failure.
+     */
+    gitStatus: (workspacePath: string, signal?: AbortSignal) => Promise<GitStatusResult>;
+    /**
+     * Read one path's patch.
+     * @param request - the path and which index to compare.
+     * @param signal - cancellation for the reading.
+     * @returns the patch, or a classified failure.
+     */
+    gitDiff: (request: GitDiffRequest, signal?: AbortSignal) => Promise<GitDiffResult>;
+    /**
+     * Stage paths into the index.
+     * @param workspacePath - the workspace the reading came from.
+     * @param paths - repository-relative paths.
+     * @returns the reading after the write, or a classified failure.
+     */
+    gitStage: (workspacePath: string, paths: readonly string[]) => Promise<GitStageResult>;
+    /**
+     * Take paths back out of the index.
+     * @param workspacePath - the workspace the reading came from.
+     * @param paths - repository-relative paths.
+     * @returns the reading after the write, or a classified failure.
+     */
+    gitUnstage: (workspacePath: string, paths: readonly string[]) => Promise<GitStageResult>;
+    /**
+     * Record the staged changes.
+     * @param workspacePath - the workspace the reading came from.
+     * @param message - the commit message.
+     * @param amend - replace the previous commit instead of adding one.
+     * @returns the new commit and the reading after it, or a classified failure.
+     */
+    gitCommit: (workspacePath: string, message: string, amend: boolean) => Promise<GitCommitResult>;
+    /**
+     * Send the current branch's commits to its remote.
+     * @param workspacePath - the workspace the reading came from.
+     * @param setUpstream - publish a branch that has no upstream instead of refusing it.
+     * @returns the push and the reading after it, or a classified failure.
+     */
+    gitPush: (workspacePath: string, setUpstream: boolean) => Promise<GitPushResult>;
+    /**
+     * Ask the deployment's model to write a commit message for what is staged.
+     * @param workspacePath - the workspace the reading came from.
+     * @param amend - draft for an amend, which describes the previous commit's content too.
+     * @param signal - cancellation for the readings and the model call.
+     * @returns the drafted message, or a classified failure.
+     */
+    gitCommitMessage: (workspacePath: string, amend: boolean, signal?: AbortSignal) => Promise<GitCommitMessageResult>;
+    /**
+     * Allocate a panel terminal.
+     * @param workspacePath - the directory to start in.
+     * @param cols - measured column count.
+     * @param rows - measured row count.
+     * @returns the handle, or a classified failure.
+     */
+    terminalOpen: (workspacePath: string, cols: number, rows: number) => Promise<TerminalOpenResult>;
+    /**
+     * Read terminal output from the offset already rendered.
+     * @param terminalId - the handle.
+     * @param fromOffset - the rendered offset.
+     * @returns the delta, or a classified failure.
+     */
+    terminalRead: (terminalId: string, fromOffset: number) => Promise<TerminalReadResult>;
+    /**
+     * Send keystrokes.
+     * @param terminalId - the handle.
+     * @param data - text delivered verbatim.
+     * @returns settlement, or a classified failure.
+     */
+    terminalWrite: (terminalId: string, data: string) => Promise<TerminalAckResult>;
+    /**
+     * Interrupt the terminal's foreground process group.
+     * @param terminalId - the handle.
+     * @returns settlement, or a classified failure.
+     */
+    terminalInterrupt: (terminalId: string) => Promise<TerminalAckResult>;
+    /**
+     * Close a terminal.
+     * @param terminalId - the handle.
+     * @returns settlement, or a classified failure.
+     */
+    terminalClose: (terminalId: string) => Promise<TerminalAckResult>;
+    /**
+     * List one directory level inside a workspace.
+     * @param path - absolute directory.
+     * @param workspacePath - the directory the listing must stay inside.
+     * @param signal - cancellation for the listing.
+     * @returns the level, or a classified failure.
+     */
+    listEntries: (path: string, workspacePath: string, signal?: AbortSignal) => Promise<ListEntriesResult>;
+    /**
+     * Read one file for preview.
+     * @param path - the file.
+     * @param workspacePath - the directory it must stay inside.
+     * @param signal - cancellation for the read.
+     * @returns the preview, or a classified failure.
+     */
+    readFile: (path: string, workspacePath: string, signal?: AbortSignal) => Promise<ReadFileResult>;
+    /**
+     * List one workspace's preview launch configurations, each with its current state.
+     * @param workspacePath - the workspace to read.
+     * @param signal - cancellation for the read.
+     * @returns the list, or a classified failure.
+     */
+    previewList: (workspacePath: string, signal?: AbortSignal) => Promise<PreviewListResult>;
+    /**
+     * Start one preview configuration.
+     * @param workspacePath - the workspace it belongs to.
+     * @param name - the configuration name.
+     * @returns the started row, or a classified failure.
+     */
+    previewStart: (workspacePath: string, name: string) => Promise<PreviewStartResult>;
+    /**
+     * Stop one running preview server.
+     * @param serverId - the handle.
+     * @returns settlement, or a classified failure.
+     */
+    previewStop: (serverId: string) => Promise<PreviewStopResult>;
+    /**
+     * Read one preview server's output from the offset already rendered, with its state.
+     * @param serverId - the handle.
+     * @param fromOffset - the rendered offset.
+     * @returns the delta and the state, or a classified failure.
+     */
+    previewLogs: (serverId: string, fromOffset: number) => Promise<PreviewLogsResult>;
+    /**
+     * Open one path with the Host operating system's default application.
+     * @param path - the absolute path.
+     * @returns after the Host answered; a failure surfaces as a notice.
+     */
+    openPath: (path: string) => Promise<void>;
+    /**
+     * Hand one path to an Open in target.
+     * @param targetId - the target's id.
+     * @param path - the absolute path.
+     * @returns after the launch settled.
+     */
+    openIn: (targetId: string, path: string) => Promise<void>;
+    /**
+     * Stop one live background task.
+     * @param sessionId - the owning session.
+     * @param taskId - the task.
+     * @returns what the registry did, or a classified failure.
+     */
+    taskKill: (sessionId: string, taskId: string) => Promise<TaskKillResult>;
+    /**
+     * Read one settled task's output.
+     * @param sessionId - the owning session.
+     * @param taskId - the task.
+     * @returns the output, or a classified failure.
+     */
+    taskOutput: (sessionId: string, taskId: string) => Promise<TaskOutputResult>;
+    /**
+     * Commit the pending Delete.
+     * @param sessionId - the session to delete.
+     * @returns what was done, or a classified failure.
+     */
+    deleteSession: (sessionId: string) => Promise<DeleteSessionResult>;
+    /**
+     * Copy text to the clipboard.
+     * @param text - the text to copy.
+     * @returns whether the browser accepted it.
+     */
+    copy: (text: string) => Promise<boolean>;
+    /** Close the dock. */
+    close: () => void;
+    /**
+     * Store the width a resize settled on, for this browser session.
+     * @param width - the width in pixels.
+     */
+    setDockWidth: (width: number) => void;
+    /**
+     * Persist the width a resize settled on into the settings section.
+     * @param width - the width in pixels.
+     * @returns settlement after the write; refused scopes reject and the dock keeps its own copy.
+     */
+    setPanelWidth: (width: number) => Promise<void>;
+    /**
+     * Add one terminal tab, in the state it has before its shell has been allocated.
+     * @param key - the terminal group key.
+     * @param tabId - the caller-generated tab id the allocation will be recorded against.
+     */
+    addTerminal: (key: string, tabId: string) => void;
+    /**
+     * Record what one tab's allocation answered.
+     * @param key - the terminal group key.
+     * @param tabId - the tab the allocation was for.
+     * @param outcome - the handle and the shell, or the failure.
+     */
+    settleTerminal: (key: string, tabId: string, outcome: {
+        terminalId: string;
+        shell: string;
+    } | {
+        error: string;
+    }) => void;
+    /**
+     * Show one tab's screen.
+     * @param key - the terminal group key.
+     * @param tabId - the tab to show.
+     */
+    activateTerminal: (key: string, tabId: string) => void;
+    /**
+     * Drop one tab and close the shell it held.
+     * @param key - the terminal group key.
+     * @param tabId - the tab to close.
+     * @returns after the Host answered; a failure surfaces as a notice.
+     */
+    closeTerminal: (key: string, tabId: string) => Promise<void>;
+    /**
+     * Dismiss one notice, ignoring a request for one already replaced.
+     * @param id - the notice to dismiss.
+     */
+    dismissNotice: (id: number) => void;
+    /** Dismiss the Delete confirmation without acting. */
+    dismissDelete: () => void;
+    /**
+     * Withdraw everything a session owned, because that session left the list.
+     * @param sessionId - the session that disappeared.
+     */
+    forgetSession: (sessionId: string) => void;
+    /**
+     * Commit the confirmed Delete and report its outcome as a notice.
+     * @param target - the session to delete.
+     * @returns after the Host answered.
+     */
+    commitDelete: (target: OperationTarget) => Promise<void>;
+    /**
+     * Report one message under the dock.
+     * @param tone - whether the message reports a failure.
+     * @param text - the message.
+     */
+    notify: (tone: 'info' | 'error', text: string) => void;
+}
+/** Full props of the frame-wide dock. */
+export type PanelHostProps = PropsRuntime<'shell.overlay'> & PropsLocale<'advancedSidebar'> & InjectFace<PanelHostInjected>;
+/** Everything the settings card needs. */
+export interface SettingsCardInjected {
+    /** Registrant-private reactive sources the renderer binds to `use<Name>` hooks. */
+    hooks: {
+        /** The bound `advanced-sidebar` settings scope: resolved value, layers, revision, writability. */
+        sidebarSettings: SettingsScope<AdvancedSidebarSettings>;
+    };
+    /**
+     * Read the Host's capability view for the card's status line and its Open in roster.
+     * @param signal - cancellation for the probe.
+     * @returns the capability view.
+     */
+    describe: (signal?: AbortSignal) => Promise<AdvancedSidebarView>;
+    /**
+     * Store one field of the section; the bound scope owns revision fencing.
+     * @param field - the field name inside the namespace.
+     * @param value - the JSON-shaped value the control produced.
+     * @returns settlement after the write.
+     */
+    setField: (field: string, value: unknown) => Promise<void>;
+    /**
+     * Clear one optional field back to the composition layer.
+     * @param field - the field name inside the namespace.
+     * @returns settlement after the write.
+     */
+    unsetField: (field: string) => Promise<void>;
+}
+/** Full props of the plugin-settings card. */
+export type SettingsCardProps = PropsRuntime<'settings.plugin.item'> & PropsLocale<'advancedSidebar'> & InjectFace<SettingsCardInjected>;