@exagone313/dsh-podman 0.2.0-rc.4 → 0.2.0

package/dist/client/locales.d.ts

@@ -1,5 +1,10 @@
 export declare const NS = "podman";
-export type ContainerPluginKey = "cardTitle" | "cardDescription" | "versionMismatchMajor" | "versionMismatchMinor" | "versionsTitle" | "orchestrator" | "versionUnknown" | "dsh" | "copyVersions" | "copied" | "copyFailed" | "reload" | "reloading" | "notice" | "configTitle" | "defaultImage" | "socketsRoot" | "projectsRoot" | "defaultImageHint" | "save" | "discard" | "workspacesTitle" | "noContainers" | "createContainer" | "containersTitle" | "containerName" | "workspace" | "image" | "status" | "created" | "projects" | "remove" | "removePod" | "confirmRemovePod" | "recreate" | "recreateWithImage" | "imagesTitle" | "imageId" | "baseImage" | "imageTag" | "builtAt" | "packages" | "volumesTitle" | "createVolume" | "removeVolume" | "volumeName" | "secretsTitle" | "createSecret" | "secretName" | "secretCharset" | "selectImage" | "setSecret" | "removeSecret" | "removeImage" | "rebuildImage" | "rebuildAllImages" | "buildImage" | "build" | "buildImageTitle" | "pullImage" | "setDefaultImage" | "setDefaultImageTitle" | "baseImagesTitle" | "customImagesTitle" | "primitive" | "packageManager" | "parent" | "cancel" | "removeTag" | "env" | "secretEnv" | "envTitle" | "envKey" | "envValue" | "addEnv" | "removeEnv" | "secretLength" | "containerSecretsTitle" | "attachSecret" | "secretEnvName" | "detachSecret" | "none" | "unavailable" | "busy" | "confirmTitle" | "confirm" | "confirmRemoveContainer" | "confirmRecreate" | "confirmRemoveImage" | "confirmRebuildImage" | "confirmRebuildAllImages" | "confirmRemoveVolume" | "confirmSetSecret" | "confirmRemoveSecret" | "confirmDetachSecret" | "mountsTitle" | "addMount" | "mountKind" | "mountProject" | "mountProjectPath" | "browse" | "browseTitle" | "browseSelect" | "browseLoading" | "browseError" | "browseUnavailable" | "browseHidden" | "browseTruncated" | "browseOutsideRoot" | "mountDestination" | "pathsTitle" | "noPaths" | "editPaths" | "addPath" | "add" | "moveUp" | "moveDown" | "apply" | "dragToReorder" | "remountWaiting" | "remountApprove" | "remountReject" | "mountVolume" | "mountSecret" | "mountMode" | "readOnly" | "readWrite" | "remountReadOnly" | "remountReadWrite" | "confirmRemountReadOnly" | "confirmRemountReadWrite" | "confirmRemoveMount" | "cachesTitle" | "noCaches" | "cacheUsage" | "cacheKeepLatest" | "confirmCacheKeepLatest" | "cacheRemoveAll" | "confirmCacheRemoveAll" | "addContainer" | "invalidContainerName" | "containerNameTaken" | "invalidName" | "invalidImageId" | "terminalSignal" | "terminalExitCode" | "terminalRunning" | "terminalFailed" | "terminalDone" | "terminalNoOutput" | "terminalCollapseAria" | "terminalExpandAria" | "terminalExpandRest" | "toolTitle_container_bash" | "toolTitle_container_exec" | "toolTitle_container_read" | "toolTitle_container_write" | "toolTitle_container_edit" | "toolTitle_container_glob" | "toolTitle_container_grep" | "toolTitle_container_list" | "toolTitle_container_start" | "toolTitle_container_recreate" | "toolTitle_container_remove" | "toolTitle_container_mount_list" | "toolTitle_container_mount_add" | "toolTitle_container_mount_remove" | "toolTitle_container_mount_update" | "toolTitle_container_path_set" | "toolTitle_container_path_add" | "toolTitle_container_path_remove" | "toolTitle_container_secret_add" | "toolTitle_container_secret_remove" | "toolTitle_image_list" | "toolTitle_image_get" | "toolTitle_image_build" | "toolTitle_image_rebuild" | "toolTitle_image_rebuild_all" | "toolTitle_image_remove" | "toolTitle_volume_list" | "toolTitle_volume_create" | "toolTitle_volume_remove" | "toolTitle_secret_list" | "toolTitle_secret_create" | "toolTitle_secret_remove" | "toolTitle_daemon_start" | "toolTitle_daemon_list" | "toolTitle_daemon_logs" | "toolTitle_daemon_restart" | "toolTitle_daemon_stop";
+export type ContainerPluginKey = "cardTitle" | "cardDescription" | "versionMismatchMajor" | "versionMismatchMinor" | "versionsTitle" | "orchestrator" | "versionUnknown" | "dsh" | "copyVersions" | "copied" | "copyFailed" | "reload" | "notice" | "defaultImage" | "defaultImageHint" | "defaultEnvironment" | "defaultEnvironmentHint" | "gitIdentity" | "gitName" | "gitEmail" | "gitIdentityHint" | "applyDefaults" | "confirmApplyDefaults" | "clear" | "save" | "discard" | "workspacesTitle" | "noContainers" | "createContainer" | "containerName" | "image" | "status" | "created" | "projects" | "remove" | "removePod" | "confirmRemovePod" | "recreate" | "recreateWithImage" | "imagesTitle" | "imageId" | "imageTag" | "builtAt" | "packages" | "volumesTitle" | "createVolume" | "removeVolume" | "volumeName" | "secretsTitle" | "createSecret" | "secretName" | "secretCharset" | "selectImage" | "setSecret" | "removeSecret" | "removeImage" | "rebuildImage" | "rebuildAllImages" | "buildImage" | "build" | "buildImageTitle" | "pullImage" | "setDefaultImage" | "setDefaultImageTitle" | "baseImagesTitle" | "customImagesTitle" | "primitive" | "packageManager" | "parent" | "cancel" | "removeTag" | "env" | "secretEnv" | "envTitle" | "envKey" | "envValue" | "addEnv" | "removeEnv" | "secretLength" | "containerSecretsTitle" | "attachSecret" | "secretEnvName" | "detachSecret" | "none" | "unavailable" | "busy" | "confirmTitle" | "confirm" | "confirmRemoveContainer" | "confirmRecreate" | "confirmRemoveImage" | "confirmRebuildImage" | "confirmRebuildAllImages" | "confirmRemoveVolume" | "confirmSetSecret" | "confirmRemoveSecret" | "confirmDetachSecret" | "mountsTitle" | "addMount" | "mountKind" | "mountProject" | "mountProjectPath" | "browse" | "browseTitle" | "browseSelect" | "browseLoading" | "browseError" | "browseUnavailable" | "browseHidden" | "browseTruncated" | "browseOutsideRoot" | "mountDestination" | "pathsTitle" | "noPaths" | "editPaths" | "addPath" | "add" | "moveUp" | "moveDown" | "apply" | "dragToReorder" | "remountWaiting" | "remountApprove" | "remountReject" | "mountVolume" | "mountSecret" | "mountTmpfs" | "mountAt" | "mountMode" | "readOnly" | "readWrite" | "mountReadOnlySuffix" | "mountReadWriteSuffix" | "remountReadOnly" | "remountReadWrite" | "confirmRemountReadOnly" | "confirmRemountReadWrite" | "confirmRemoveMount" | "cachesTitle" | "noCaches" | "cacheUsage" | "cacheKeepLatest" | "confirmCacheKeepLatest" | "cacheRemoveAll" | "confirmCacheRemoveAll" | "addContainer" | "invalidContainerName" | "containerNameTaken" | "invalidName" | "invalidImageId" | "terminalSignal" | "terminalExitCode" | "terminalNoExitCode" | "terminalRunning" | "terminalFailed" | "terminalDone" | "terminalNoOutput" | "terminalCollapseAria" | "terminalExpandAria" | "terminalExpandRest" | "toolTitle_container_bash" | "toolTitle_container_exec" | "toolTitle_container_read" | "toolTitle_container_write" | "toolTitle_container_edit" | "toolTitle_container_glob" | "toolTitle_container_grep" | "toolTitle_container_list" | "toolTitle_container_start" | "toolTitle_container_recreate" | "toolTitle_container_remove" | "toolTitle_container_mount_list" | "toolTitle_container_mount_add" | "toolTitle_container_mount_remove" | "toolTitle_container_mount_update" | "toolTitle_container_path_set" | "toolTitle_container_path_add" | "toolTitle_container_path_remove" | "toolTitle_container_secret_add" | "toolTitle_container_secret_remove" | "toolTitle_image_list" | "toolTitle_image_get" | "toolTitle_image_build" | "toolTitle_image_rebuild" | "toolTitle_image_rebuild_all" | "toolTitle_image_remove" | "toolTitle_volume_list" | "toolTitle_volume_create" | "toolTitle_volume_remove" | "toolTitle_secret_list" | "toolTitle_secret_create" | "toolTitle_secret_remove" | "toolTitle_daemon_start" | "toolTitle_daemon_list" | "toolTitle_daemon_logs" | "toolTitle_daemon_restart" | "toolTitle_daemon_stop" | "terminalTabTitle" | "terminalGuideTitle" | "terminalGuideDescription" | "terminalShortcut" | "terminalShortcutNoSession" | "terminalContainer" | "terminalShell" | "terminalDefaultContainer" | "terminalStart" | "terminalConnect" | "terminalReconnect" | "terminalStatusConnecting" | "terminalStatusRunning" | "terminalStatusExited" | "terminalStatusDetached" | "terminalNoShells" | "terminalShellsFailed" | "terminalLoading";
+/**
+ * Translate one key, interpolating `{name}` placeholders when given. Components
+ * that build dialog copy declare this so they can name their subject.
+ */
+export type Translate = (key: ContainerPluginKey, params?: Record<string, string>) => string;
 export declare const en: Record<ContainerPluginKey, string>;
 export declare const zh: Record<ContainerPluginKey, string>;
 declare module "@deepseek-ai/dsh-client-ui-slots" {

package/dist/client/locales.js

@@ -15,33 +15,35 @@ export const en = {
     copied: "Copied",
     copyFailed: "Copy failed",
     reload: "Reload this view",
-    reloading: "Reloading…",
     notice: "Notice",
-    configTitle: "Configuration",
     defaultImage: "Default image",
-    socketsRoot: "Sockets root",
-    projectsRoot: "Projects root",
     defaultImageHint: "Image used when a workspace has no image of its own.",
+    defaultEnvironment: "Default environment",
+    defaultEnvironmentHint: "Seeded into a container when it is created. Edit a container's own environment and recreate it to change or remove a value for that container.",
+    gitIdentity: "Git identity",
+    gitName: "Name",
+    gitEmail: "Email",
+    gitIdentityHint: "Fills GIT_AUTHOR_NAME/EMAIL and GIT_COMMITTER_NAME/EMAIL for new containers, so commits made inside them are attributed to you.",
+    applyDefaults: "Apply default environment variables",
+    confirmApplyDefaults: "Add the default environment variables to the containers that are missing them? Matching running containers are recreated (their processes and daemons stop); existing values are kept and stopped containers are left alone.",
+    clear: "Clear",
     save: "Save",
     discard: "Discard",
     workspacesTitle: "Workspaces",
     noContainers: "This workspace has no containers yet.",
     createContainer: "Create container",
-    containersTitle: "Containers",
     containerName: "Container",
-    workspace: "Workspace",
     image: "Image",
     status: "Status",
     created: "Created",
     projects: "Projects",
     remove: "Remove",
     removePod: "Remove pod",
-    confirmRemovePod: "Remove this workspace's pod and all its containers? Volume and project data is kept.",
+    confirmRemovePod: "Remove the pod of workspace “{workspace}” and all its containers? Volume and project data is kept.",
     recreate: "Recreate",
     recreateWithImage: "Recreate with image",
     imagesTitle: "Images",
     imageId: "Image ID",
-    baseImage: "Base image",
     imageTag: "Tag",
     builtAt: "Built at",
     packages: "Packages",
@@ -89,15 +91,15 @@ export const en = {
     busy: "Working…",
     confirmTitle: "Confirm action",
     confirm: "Confirm",
-    confirmRemoveContainer: "Remove the default container of this workspace?",
-    confirmRecreate: "Recreate this container? Its ephemeral state is lost.",
-    confirmRemoveImage: "Remove this image? Containers using it must be recreated from another image.",
-    confirmRebuildImage: "Rebuild this image in place?",
+    confirmRemoveContainer: "Remove container “{container}” from workspace “{workspace}”?",
+    confirmRecreate: "Recreate container “{container}” in workspace “{workspace}”? Its ephemeral state is lost.",
+    confirmRemoveImage: "Remove image “{image}”? Containers using it must be recreated from another image.",
+    confirmRebuildImage: "Rebuild image “{image}” in place?",
     confirmRebuildAllImages: "Rebuild every image in dependency order (base first)?",
-    confirmRemoveVolume: "Remove this volume and its data?",
-    confirmSetSecret: "Overwrite this secret's value?",
-    confirmRemoveSecret: "Remove this secret? Containers using it must drop it first.",
-    confirmDetachSecret: "Detach this secret environment variable from the container?",
+    confirmRemoveVolume: "Remove volume “{volume}” and its data?",
+    confirmSetSecret: "Overwrite the value of secret “{secret}”?",
+    confirmRemoveSecret: "Remove secret “{secret}”? Containers using it must drop it first.",
+    confirmDetachSecret: "Detach secret “{secret}” from environment variable {env}?",
     mountsTitle: "Mounts",
     addMount: "Add mount",
     mountKind: "Kind",
@@ -127,14 +129,18 @@ export const en = {
     remountReject: "Reject",
     mountVolume: "Volume",
     mountSecret: "Secret",
+    mountTmpfs: "tmpfs",
+    mountAt: "at",
     mountMode: "Mode",
     readOnly: "Read-only",
     readWrite: "Read-write",
+    mountReadOnlySuffix: "(ro)",
+    mountReadWriteSuffix: "(rw)",
     remountReadOnly: "Remount as read-only",
     remountReadWrite: "Remount as read-write",
-    confirmRemountReadOnly: "Remount this mount as read-only and recreate the container?",
-    confirmRemountReadWrite: "Remount this mount as read-write and recreate the container?",
-    confirmRemoveMount: "Remove this mount from the container and recreate it?",
+    confirmRemountReadOnly: "Remount {mount} as read-only and recreate the container?",
+    confirmRemountReadWrite: "Remount {mount} as read-write and recreate the container?",
+    confirmRemoveMount: "Remove mount {mount} from the container and recreate it?",
     cachesTitle: "Package caches",
     noCaches: "No package cache is configured.",
     cacheUsage: "{size} · {n} files",
@@ -149,6 +155,7 @@ export const en = {
     invalidImageId: "Start with a letter, digit, or '_'; only letters, digits, '.', '_', '-', '/', ':' (max 128).",
     terminalSignal: "signal {signal}",
     terminalExitCode: "exit code {code}",
+    terminalNoExitCode: "no exit code",
     terminalRunning: "Running",
     terminalFailed: "Failed",
     terminalDone: "Done",
@@ -193,6 +200,24 @@ export const en = {
     toolTitle_daemon_logs: "Daemon logs",
     toolTitle_daemon_restart: "Restart daemon",
     toolTitle_daemon_stop: "Stop daemon",
+    terminalTabTitle: "Terminal",
+    terminalGuideTitle: "New terminal",
+    terminalGuideDescription: "Run commands in the Session workspace",
+    terminalShortcut: "New terminal",
+    terminalShortcutNoSession: "Select a session first",
+    terminalContainer: "Container",
+    terminalShell: "Shell",
+    terminalDefaultContainer: "Default container",
+    terminalStart: "Start",
+    terminalConnect: "Connect",
+    terminalReconnect: "Reconnect",
+    terminalStatusConnecting: "Connecting…",
+    terminalStatusRunning: "Connected",
+    terminalStatusExited: "Process exited ({code})",
+    terminalStatusDetached: "Detached (opened elsewhere)",
+    terminalNoShells: "No shells available",
+    terminalShellsFailed: "Could not list shells: {message}",
+    terminalLoading: "Loading…",
 };
 export const zh = {
     cardTitle: "dsh-podman",
@@ -207,33 +232,35 @@ export const zh = {
     copied: "已复制",
     copyFailed: "复制失败",
     reload: "刷新此视图",
-    reloading: "刷新中…",
     notice: "提示",
-    configTitle: "配置",
     defaultImage: "默认镜像",
-    socketsRoot: "套接字根目录",
-    projectsRoot: "项目根目录",
     defaultImageHint: "工作区没有自带镜像时使用的镜像。",
+    defaultEnvironment: "默认环境变量",
+    defaultEnvironmentHint: "容器创建时注入的环境变量。编辑容器自身的环境变量后重建该容器，即可修改或移除其中的某一项。",
+    gitIdentity: "Git 身份",
+    gitName: "姓名",
+    gitEmail: "邮箱",
+    gitIdentityHint: "为新容器填入 GIT_AUTHOR_NAME/EMAIL 与 GIT_COMMITTER_NAME/EMAIL，使容器内提交的提交者信息正确。",
+    applyDefaults: "应用默认环境变量",
+    confirmApplyDefaults: "为缺少默认环境变量的容器补上这些变量？匹配的运行中容器会被重建（其进程与守护进程会停止）；已有值保持不变，已停止的容器不会被处理。",
+    clear: "清除",
     save: "保存",
     discard: "放弃",
     workspacesTitle: "工作区",
     noContainers: "该工作区还没有容器。",
     createContainer: "创建容器",
-    containersTitle: "容器",
     containerName: "容器",
-    workspace: "工作区",
     image: "镜像",
     status: "状态",
     created: "创建时间",
     projects: "项目",
     remove: "移除",
     removePod: "移除 Pod",
-    confirmRemovePod: "移除该工作区的 Pod 及其所有容器？卷和项目数据会保留。",
+    confirmRemovePod: "移除工作区“{workspace}”的 Pod 及其所有容器？卷和项目数据会保留。",
     recreate: "重建",
     recreateWithImage: "使用镜像重建",
     imagesTitle: "镜像",
     imageId: "镜像 ID",
-    baseImage: "基础镜像",
     imageTag: "标签",
     builtAt: "构建时间",
     packages: "软件包",
@@ -281,15 +308,15 @@ export const zh = {
     busy: "处理中…",
     confirmTitle: "确认操作",
     confirm: "确认",
-    confirmRemoveContainer: "移除该工作区的默认容器？",
-    confirmRecreate: "重建该容器？其临时状态将丢失。",
-    confirmRemoveImage: "移除该镜像？使用它的容器需要用其他镜像重建。",
-    confirmRebuildImage: "就地重建该镜像？",
+    confirmRemoveContainer: "移除工作区“{workspace}”中的容器“{container}”？",
+    confirmRecreate: "重建工作区“{workspace}”中的容器“{container}”？其临时状态将丢失。",
+    confirmRemoveImage: "移除镜像“{image}”？使用它的容器需要用其他镜像重建。",
+    confirmRebuildImage: "就地重建镜像“{image}”？",
     confirmRebuildAllImages: "按依赖顺序重建全部镜像（先基础镜像）？",
-    confirmRemoveVolume: "移除该卷及其数据？",
-    confirmSetSecret: "覆盖该机密的值？",
-    confirmRemoveSecret: "移除该机密？使用它的容器需先移除注入。",
-    confirmDetachSecret: "从容器上移除该机密环境变量？",
+    confirmRemoveVolume: "移除卷“{volume}”及其数据？",
+    confirmSetSecret: "覆盖机密“{secret}”的值？",
+    confirmRemoveSecret: "移除机密“{secret}”？使用它的容器需先移除注入。",
+    confirmDetachSecret: "从环境变量 {env} 上移除机密“{secret}”？",
     mountsTitle: "挂载",
     addMount: "添加挂载",
     mountKind: "类型",
@@ -319,14 +346,18 @@ export const zh = {
     remountReject: "拒绝",
     mountVolume: "卷",
     mountSecret: "机密",
+    mountTmpfs: "tmpfs",
+    mountAt: "位于",
     mountMode: "模式",
     readOnly: "只读",
     readWrite: "读写",
+    mountReadOnlySuffix: "(只读)",
+    mountReadWriteSuffix: "(读写)",
     remountReadOnly: "重新挂载为只读",
     remountReadWrite: "重新挂载为读写",
-    confirmRemountReadOnly: "将该挂载重新挂载为只读并重建容器？",
-    confirmRemountReadWrite: "将该挂载重新挂载为读写并重建容器？",
-    confirmRemoveMount: "从容器中移除该挂载并重建容器？",
+    confirmRemountReadOnly: "将 {mount} 重新挂载为只读并重建容器？",
+    confirmRemountReadWrite: "将 {mount} 重新挂载为读写并重建容器？",
+    confirmRemoveMount: "从容器中移除挂载 {mount} 并重建容器？",
     cachesTitle: "软件包缓存",
     noCaches: "未配置软件包缓存。",
     cacheUsage: "{size} · {n} 个文件",
@@ -341,6 +372,7 @@ export const zh = {
     invalidImageId: "以字母、数字或 '_' 开头，仅可使用字母、数字、'.'、'_'、'-'、'/'、':'（最长 128 个字符）。",
     terminalSignal: "信号 {signal}",
     terminalExitCode: "退出码 {code}",
+    terminalNoExitCode: "无退出码",
     terminalRunning: "运行中",
     terminalFailed: "失败",
     terminalDone: "已完成",
@@ -385,4 +417,22 @@ export const zh = {
     toolTitle_daemon_logs: "守护进程日志",
     toolTitle_daemon_restart: "重启守护进程",
     toolTitle_daemon_stop: "停止守护进程",
+    terminalTabTitle: "终端",
+    terminalGuideTitle: "新建终端",
+    terminalGuideDescription: "在会话工作区运行命令",
+    terminalShortcut: "新建终端",
+    terminalShortcutNoSession: "请先选择会话",
+    terminalContainer: "容器",
+    terminalShell: "Shell",
+    terminalDefaultContainer: "默认容器",
+    terminalStart: "启动",
+    terminalConnect: "连接",
+    terminalReconnect: "重新连接",
+    terminalStatusConnecting: "正在连接…",
+    terminalStatusRunning: "已连接",
+    terminalStatusExited: "进程已退出（{code}）",
+    terminalStatusDetached: "已在其他位置打开",
+    terminalNoShells: "没有可用的 Shell",
+    terminalShellsFailed: "读取 Shell 失败：{message}",
+    terminalLoading: "正在加载…",
 };

package/dist/client/podman-terminal-guide.d.ts

@@ -0,0 +1,11 @@
+import type { InjectFace, PropsLocale, PropsRuntime } from "@deepseek-ai/dsh-client-ui-slots";
+import { type ReactNode } from "react";
+import type { ContainerCardFace } from "./container-card-controller.js";
+import { NS } from "./locales.js";
+/** The card snapshot the guide reads; the tab's own actions open the terminal. */
+export interface PodmanTerminalGuideInjected extends ContainerCardFace {
+    /** Owning session, used by the shells route and the injection contract. */
+    readonly sessionId: string;
+}
+export type PodmanTerminalGuideProps = PropsRuntime<"sidebar.right.tab.guide.entry"> & PropsLocale<typeof NS> & InjectFace<PodmanTerminalGuideInjected>;
+export declare function PodmanTerminalGuide(props: PodmanTerminalGuideProps): ReactNode;

package/dist/client/podman-terminal-guide.js

@@ -0,0 +1,208 @@
+import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+// SPDX-FileCopyrightText: 2026 Elouan Martinet <exa@elou.world>
+//
+// SPDX-License-Identifier: MIT
+// The Podman terminal's guide card: pick a container and one of the shells that
+// container really offers, then open a new terminal tab bound to that target in
+// the Session's own workspace. It reads the same settings-card snapshot as the
+// tab body and never asks for a workspace, because each Session has exactly one.
+import { Button, PluginArtworkTerminal, } from "@deepseek-ai/dsh-client-ui-primitives";
+import { useEffect, useState } from "react";
+import { fieldLabel, fieldSelect, hint } from "./container-card-styles.js";
+import { ContainerField } from "./podman-terminal.js";
+import { PODMAN_TERMINAL_KIND } from "./terminal-tab.js";
+import { readTerminalTarget, writeTerminalTarget, } from "./terminal-preference.js";
+import { containerOptions, validContainer, validShell, } from "./terminal-targets.js";
+import { fetchTerminalShells, fetchTerminalTarget, } from "./terminal-transport.js";
+export function PodmanTerminalGuide(props) {
+    const { t, sessionId } = props;
+    const { tab } = props.useTabInfo();
+    const state = props.useContainerCard((snapshot) => snapshot);
+    // The host resolves the Session's workspace and reports it when it cannot.
+    const [target, setTarget] = useState({ phase: "loading" });
+    const workspace = target.phase === "ready"
+        ? target.target.workspace
+        : undefined;
+    const workspaceSlug = target.phase === "ready"
+        ? target.target.workspaceSlug
+        : undefined;
+    const unknownWorkspace = target.phase === "failed";
+    const [container, setContainer] = useState(undefined);
+    const [shells, setShells] = useState({ phase: "loading" });
+    const [shell, setShell] = useState(undefined);
+    // The last target this browser started from the card, reused below while it
+    // is still valid. Read once: the card shows it, it does not track it.
+    const [stored] = useState(() => readTerminalTarget());
+    useEffect(() => {
+        props.reload();
+    }, [props.reload]);
+    useEffect(() => {
+        const controller = new AbortController();
+        setTarget({ phase: "loading" });
+        void fetchTerminalTarget(sessionId, controller.signal).then((resolved) => {
+            if (!controller.signal.aborted) {
+                setTarget({ phase: "ready", target: resolved });
+            }
+        }, (error) => {
+            if (controller.signal.aborted)
+                return;
+            setTarget({
+                phase: "failed",
+                message: error instanceof Error ? error.message : String(error),
+            });
+        });
+        return () => {
+            controller.abort();
+        };
+    }, [sessionId]);
+    // The empty value means the workspace's default container; the workspace
+    // row's own containerName is that container's podman name, which the
+    // orchestrator rejects, so it is never used as a target. The choice waits for
+    // the first snapshot, otherwise the empty default would pre-empt a remembered
+    // named container before the options are known.
+    useEffect(() => {
+        if (unknownWorkspace || workspace === undefined || container !== undefined) {
+            return;
+        }
+        if (state.busy)
+            return;
+        setContainer(validContainer(stored?.container, containerOptions(state.containers, workspaceSlug)));
+    }, [
+        unknownWorkspace,
+        workspace,
+        container,
+        state.busy,
+        state.containers,
+        workspaceSlug,
+        stored,
+    ]);
+    useEffect(() => {
+        if (workspace === undefined || workspace === "" || container === undefined) {
+            return;
+        }
+        const controller = new AbortController();
+        setShells({ phase: "loading" });
+        void fetchTerminalShells(workspace, container, sessionId, controller.signal).then((list) => {
+            if (controller.signal.aborted)
+                return;
+            setShells({ phase: "ready", shells: list });
+            setShell((previous) => previous ?? validShell(stored?.shell, list) ?? list[0]?.path);
+        }, (error) => {
+            if (controller.signal.aborted)
+                return;
+            setShells({
+                phase: "failed",
+                message: error instanceof Error ? error.message : String(error),
+            });
+        });
+        return () => {
+            controller.abort();
+        };
+    }, [workspace, container, sessionId]);
+    const shellList = shells.phase === "ready" ? shells.shells : [];
+    const ready = !unknownWorkspace && container !== undefined &&
+        shell !== undefined &&
+        shellList.length > 0;
+    return (_jsxs("div", { style: CARD_STYLE, "data-sidebar-right-guide-entry": props.kind, children: [_jsxs("div", { style: HEADER_STYLE, children: [_jsx("span", { style: ICON_STYLE, "aria-hidden": "true", children: _jsx(PluginArtworkTerminal, { size: 22 }) }), _jsxs("span", { style: TEXT_STYLE, children: [_jsx("span", { style: TITLE_STYLE, children: props.title }), props.description === undefined
+                                ? null
+                                : _jsx("span", { style: DESCRIPTION_STYLE, children: props.description })] })] }), state.workspaces.length === 0
+                ? (_jsx("p", { style: hint, role: "status", children: state.busy ? t("terminalLoading") : t("unavailable") }))
+                : (_jsxs(_Fragment, { children: [target.phase === "failed" && (_jsx("p", { style: hint, role: "alert", children: target.message })), _jsxs("div", { style: FIELDS_STYLE, children: [_jsx(ContainerField, { containers: state.containers, workspaceSlug: workspaceSlug, container: container, disabled: unknownWorkspace, label: t("terminalContainer"), defaultLabel: t("terminalDefaultContainer"), selectStyle: fieldSelect, onContainer: (value) => {
+                                        // The new container may not offer the current shell, so the
+                                        // shells effect re-picks one (remembered when still valid).
+                                        setContainer(value);
+                                        setShell(undefined);
+                                    } }), _jsx("span", { style: fieldLabel, children: t("terminalShell") }), _jsx("select", { style: fieldSelect, "aria-label": t("terminalShell"), value: shell ?? "", disabled: unknownWorkspace || shells.phase !== "ready" ||
+                                        shellList.length === 0, onChange: (event) => {
+                                        setShell(event.target.value);
+                                    }, children: shellList.length === 0
+                                        ? (_jsx("option", { value: "", children: unknownWorkspace
+                                                ? ""
+                                                : shells.phase === "loading"
+                                                    ? t("terminalLoading")
+                                                    : t("terminalNoShells") }))
+                                        : shellList.map((entry) => (_jsx("option", { value: entry.path, children: entry.name }, entry.path))) })] }), !unknownWorkspace && shells.phase === "failed" && (_jsx("p", { style: hint, role: "alert", children: t("terminalShellsFailed", { message: shells.message }) })), !unknownWorkspace && shells.phase === "loading" && (_jsx("p", { style: hint, role: "status", children: t("terminalLoading") })), !unknownWorkspace && shells.phase === "ready" &&
+                            shellList.length === 0 && (_jsx("p", { style: hint, role: "status", children: t("terminalNoShells") })), _jsx("div", { style: ACTIONS_STYLE, children: _jsx(Button, { variant: "primary", size: "sm", disabled: !ready, onClick: () => {
+                                    if (container === undefined || shell === undefined)
+                                        return;
+                                    writeTerminalTarget({ container, shell });
+                                    // Replace the guide tab in place, exactly like the built-in
+                                    // guide cards, instead of adding a second terminal tab.
+                                    tab.actions.openTab(PODMAN_TERMINAL_KIND, {
+                                        replaceTab: true,
+                                        params: { container, shell },
+                                    });
+                                }, children: t("terminalStart") }) })] }))] }));
+}
+// The card mirrors the harness guide capsule skin (`GuideBody .entry`): same
+// padding, radius token, border and background as the entries beside it, so the
+// glyph and title line up; the column layout and the internal gaps are ours
+// because this card carries controls rather than being one clickable capsule.
+const CARD_STYLE = {
+    display: "flex",
+    flexDirection: "column",
+    gap: "8px",
+    boxSizing: "border-box",
+    width: "100%",
+    padding: "14px 20px",
+    border: "0.5px solid var(--dsw-alias-border-l3)",
+    borderRadius: "var(--dsl-guide-entry-radius)",
+    background: "var(--dsw-alias-bg-layer-1)",
+};
+const HEADER_STYLE = {
+    display: "flex",
+    alignItems: "center",
+    gap: "14px",
+    minWidth: 0,
+};
+const ICON_STYLE = {
+    display: "flex",
+    flex: "none",
+    alignItems: "center",
+    justifyContent: "center",
+    width: "26px",
+    height: "26px",
+    color: "var(--dsw-alias-label-secondary)",
+};
+const TEXT_STYLE = {
+    display: "flex",
+    flex: 1,
+    flexDirection: "column",
+    gap: "2px",
+    minWidth: 0,
+};
+const TITLE_STYLE = {
+    overflow: "hidden",
+    color: "var(--dsw-alias-label-primary)",
+    fontSize: "14px",
+    lineHeight: 1.4,
+    whiteSpace: "nowrap",
+    textOverflow: "ellipsis",
+};
+const DESCRIPTION_STYLE = {
+    overflow: "hidden",
+    color: "var(--dsw-alias-label-tertiary)",
+    fontSize: "11px",
+    lineHeight: 1.4,
+    whiteSpace: "nowrap",
+    textOverflow: "ellipsis",
+};
+// A centred label/select grid: each pair is one row, so a narrow card can never
+// wrap a label away from its control. The auto column sizes to the widest label
+// (right-aligned by `fieldLabel`), the second is capped at the select width so
+// both controls line up, and the pair is centred in the card.
+const FIELDS_STYLE = {
+    display: "grid",
+    gridTemplateColumns: "auto minmax(0, 160px)",
+    gap: "8px",
+    alignItems: "center",
+    justifyContent: "center",
+    width: "100%",
+};
+const ACTIONS_STYLE = {
+    display: "flex",
+    flexWrap: "wrap",
+    justifyContent: "center",
+    gap: "8px",
+    alignItems: "center",
+};

package/dist/client/podman-terminal-title.d.ts

@@ -0,0 +1,7 @@
+import type { InjectFace, PropsRuntime } from "@deepseek-ai/dsh-client-ui-slots";
+import { type ReactNode } from "react";
+/** Session identity the session-scope title registration injects. */
+export interface PodmanTerminalTitleInjected {
+    readonly sessionId: string;
+}
+export declare function PodmanTerminalTitle(props: PropsRuntime<"sidebar.right.pane.tab.title"> & InjectFace<PodmanTerminalTitleInjected>): ReactNode;

package/dist/client/podman-terminal-title.js

@@ -0,0 +1,30 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useSyncExternalStore } from "react";
+import { shellName } from "./terminal-targets.js";
+import { subscribeTerminalTitles, terminalTitle } from "./terminal-titles.js";
+export function PodmanTerminalTitle(props) {
+    const { tab } = props.useTabInfo();
+    const params = tab.navigation.params;
+    // Only the session-scope identity is available here, so the store is keyed the
+    // same way the host retains a terminal.
+    const key = `${props.sessionId}:${tab.id}`;
+    const fallback = shellName(params?.shell) ?? tab.title;
+    const title = useSyncExternalStore(subscribeTerminalTitles, () => terminalTitle(key) ?? fallback);
+    return (_jsxs("span", { style: CHIP_STYLE, children: [_jsx(TerminalGlyph, {}), _jsx("span", { style: TITLE_STYLE, children: title })] }));
+}
+// The built-in tab chip's 16px terminal prompt, drawn in the surrounding ink
+// instead of the plugin artwork's fixed brand palette.
+function TerminalGlyph() {
+    return (_jsxs("svg", { width: "16", height: "16", viewBox: "0 0 16 16", fill: "none", "aria-hidden": "true", children: [_jsx("path", { d: "M3 4L7 8L3 12", stroke: "currentColor" }), _jsx("path", { d: "M9 12H13", stroke: "currentColor" })] }));
+}
+const CHIP_STYLE = {
+    display: "inline-flex",
+    alignItems: "center",
+    gap: "4px",
+    minWidth: 0,
+};
+const TITLE_STYLE = {
+    overflow: "hidden",
+    whiteSpace: "nowrap",
+    textOverflow: "ellipsis",
+};

package/dist/client/podman-terminal.d.ts

@@ -0,0 +1,26 @@
+import type { InjectFace, PropsLocale, PropsRuntime } from "@deepseek-ai/dsh-client-ui-slots";
+import { type ReactNode } from "react";
+import type { ContainerView } from "./card-protocol.js";
+import type { ContainerCardFace } from "./container-card-controller.js";
+import { NS } from "./locales.js";
+/** Everything the tab body is given: framework shares plus the injected card face. */
+export interface PodmanTerminalInjected extends ContainerCardFace {
+    /** Owning session, injected by the session-scope registration. */
+    readonly sessionId: string;
+}
+export type PodmanTerminalProps = PropsRuntime<"sidebar.right.pane.tab"> & PropsLocale<typeof NS> & InjectFace<PodmanTerminalInjected>;
+/** The labelled container picker shared by the body and the guide card. */
+interface ContainerFieldProps {
+    readonly containers: readonly ContainerView[];
+    readonly workspaceSlug: string | undefined;
+    readonly container: string | undefined;
+    readonly disabled: boolean;
+    readonly label: string;
+    readonly defaultLabel: string;
+    /** Select skin; stacked cards pass a full-width variant. */
+    readonly selectStyle?: React.CSSProperties;
+    readonly onContainer: (container: string) => void;
+}
+export declare function ContainerField(props: ContainerFieldProps): ReactNode;
+export declare function PodmanTerminal(props: PodmanTerminalProps): ReactNode;
+export {};