dsh-mobile-flow 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 roc
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,63 @@
+# dsh-mobile-flow
+
+**English** | [简体中文](README.zh.md)
+
+Mobile in-flow composer for the [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) (dsh) Web UI: on narrow screens (≤720px) the input bar and AI confirmation cards scroll with the page instead of pinning to the viewport floor — swipe up to read and the message transcript gets the full screen back.
+
+A pure client-side CSS overlay. No product source is modified; removing the plugin restores the stock behavior exactly.
+
+## The problem
+
+The stock Web UI pins the composer seat with `position: sticky; bottom: 0`. That seat hosts not only the input bar but also the interactive cards the AI raises mid-conversation — `ask_user_question` option cards, approval prompts, plan review. On a phone all of them stay glued to the bottom of the screen, permanently eating a chunk of the viewport while you scroll back through replies.
+
+## What it does
+
+On viewports ≤720px (the same breakpoint the official question card uses):
+
+1. **The composer seat joins the document flow** — input bar and confirmation cards now live at the end of the transcript. Swipe up and they scroll out of view; the transcript becomes full-screen.
+2. **Short conversations still dock to the bottom** — when the transcript is shorter than one screen, the message area stretches so the composer stays flush with the viewport floor, visually identical to the stock behavior. Long conversations get the full-screen treatment.
+3. **Floating controls re-anchor** — the back-to-bottom button and turn navigator no longer reserve height for the sticky seat and sit close to the viewport floor again.
+
+Desktop (wide viewports) is completely unaffected.
+
+## How it works
+
+The plugin ships a browser half (`exports["./client"]`, declared via `dsh.client.platform: "web"`), discovered by the client-modules scanner and loaded from the boot manifest. It injects one `<style>` tag with `@media (max-width: 720px)` overrides and removes the tag on unload — fully reversible.
+
+All selectors target the product's stable `data-*` attributes (`data-composer-seat`, `data-conversation-scroll`, `data-phase`, `data-slot`), never CSS-Modules-hashed class names. The sticky-to-static switch is guarded with `:not(:has([data-conversation-composer-overlay]))` so views that own their composer overlay (e.g. trajectory) keep the official absolute positioning. On engines without `:has()` the rules degrade safely back to the stock sticky behavior.
+
+## Requirements
+
+- DeepSeek Harness Web profile (`dsh web`), any recent 0.1.x release
+- Selectors verified against 0.1.2-rc.1; they target product slot contracts that are stable within a version line but may need small updates after a major product revamp
+
+## Install
+
+### From npm
+
+```sh
+dsh plugin --profile web add dsh-mobile-flow
+```
+
+### From GitHub
+
+```sh
+dsh plugin --profile web add github:imroc/dsh-mobile-flow
+```
+
+Restart `dsh web`, then refresh the browser page.
+
+## Verify
+
+Open a session on a phone (or a desktop DevTools window narrowed to ≤720px): swipe up a few screens — the input bar and confirmation cards should scroll away with the messages. Trigger a tool that asks a question (or just check the input bar with a long transcript): the card sits at the end of the transcript instead of the screen bottom. Widen the window and the stock behavior returns.
+
+## Rollback
+
+- Bundle install: `dsh plugin --profile web remove dsh-mobile-flow`
+- Manual: remove the dependency and the `dsh.profile.bundles` entry, restart `dsh web`
+
+No product source is modified; upgrades do not overwrite it.
+
+## License
+
+MIT

package/README.zh.md

@@ -0,0 +1,63 @@
+# dsh-mobile-flow
+
+[English](README.md) | **简体中文**
+
+[DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)（dsh）Web UI 的手机端 in-flow composer 插件：窄屏（≤720px）时输入框与 AI 确认选择框随页面滚动，而不是钉死在屏幕底部——上滑阅读时消息区拿回全屏空间。
+
+纯客户端 CSS overlay，不修改产品源码；卸载插件即完全还原官方行为。
+
+## 解决的问题
+
+官方 Web UI 用 `position: sticky; bottom: 0` 把 composer 座位钉在视口底。这个座位承载的不只是输入框，还有 AI 会话中途弹出的交互卡片——`ask_user_question` 选项卡、approval 权限确认框、plan review。手机上它们全部粘在屏幕底部，往回翻阅回复时永久遮挡一块视口。
+
+## 实际效果
+
+≤720px 视口（与官方问题卡片的断点一致）下：
+
+1. **composer 座位回归文档流** —— 输入框和确认卡片位于消息流末尾。上滑时随内容滚出视口，消息全屏可读。
+2. **短会话仍然贴底** —— 消息不足一屏时消息区自动拉伸，输入框保持贴视口底，视觉与官方行为完全一致；长会话则享受全屏阅读。
+3. **浮动控件重新锚定** —— 回到底部按钮、轮次导航不再为吸底座位预留高度，回到贴近视口底的位置。
+
+桌面端（宽视口）完全不受影响。
+
+## 工作原理
+
+插件带浏览器半（`exports["./client"]`，经 `dsh.client.platform: "web"` 声明），由 client-modules 扫描器发现并从 boot manifest 装载到每个页面。注入一个 `<style>` 标签（`@media (max-width: 720px)` 覆盖），卸载时移除标签——完全可逆。
+
+所有选择器都瞄准产品的稳定 `data-*` 属性（`data-composer-seat`、`data-conversation-scroll`、`data-phase`、`data-slot`），绝不依赖 CSS Modules 哈希类名。sticky→static 切换用 `:not(:has([data-conversation-composer-overlay]))` 排除了自带 composer overlay 的视图（如 trajectory），保持官方 absolute 定位。不支持 `:has()` 的引擎上规则安全退回官方 sticky 行为。
+
+## 环境要求
+
+- DeepSeek Harness Web profile（`dsh web`），任意较新的 0.1.x 版本
+- 选择器已在 0.1.2-rc.1 上验证；它们瞄准产品 slot 契约，同一版本线内稳定，产品大改版后可能需要小幅更新
+
+## 安装
+
+### npm
+
+```sh
+dsh plugin --profile web add dsh-mobile-flow
+```
+
+### GitHub
+
+```sh
+dsh plugin --profile web add github:imroc/dsh-mobile-flow
+```
+
+重启 `dsh web`，然后刷新浏览器页面。
+
+## 验证
+
+手机上（或桌面 DevTools 缩到 ≤720px 窄窗）打开一个会话：往上滑几屏——输入框和确认卡片应随消息滚出屏幕。触发一个会提问的工具（或直接看长会话里的输入框）：卡片位于消息流末尾而非屏幕底部。拉宽窗口即恢复官方行为。
+
+## 回退
+
+- Bundle 安装：`dsh plugin --profile web remove dsh-mobile-flow`
+- 手动：移除依赖与 `dsh.profile.bundles` 条目，重启 `dsh web`
+
+不修改产品源码；升级不会覆盖。
+
+## 许可证
+
+MIT

package/cordis.patch.yml

@@ -0,0 +1,6 @@
+# Bundle patch: mount the plugin row. The row name must match this package
+# name; remove this insert block (or the bundle from the profile bundles list)
+# to restore the stock sticky-composer behavior.
+- insert:
+    - id: mobile-flow
+      name: 'dsh-mobile-flow'

package/lib/client.js

@@ -0,0 +1,67 @@
+window.__ModuleLoader__.load({
+  id: "dsh-mobile-flow",
+  factory: (require) => {
+    var module = { exports: {} };
+    var exports = module.exports;
+
+    /* Mobile in-flow composer: on narrow viewports the composer seat (input
+       bar + AI confirmation takeovers) joins the document flow, so swiping
+       up scrolls it out of view and the transcript gets the full screen.
+
+       The 720px breakpoint matches the official ui-user-questions
+       QuestionComposer narrow-screen breakpoint. On engines without :has()
+       the rules fail closed and the stock sticky behavior stays.
+
+       Selectors target the product's stable data-* attributes
+       (data-composer-seat / data-conversation-scroll / data-phase /
+       data-slot), never CSS-Modules-hashed class names; all hooks verified
+       against the 0.1.2-rc.1 shipped bundles. */
+    var CSS = [
+      "/* ── dsh-mobile-flow: in-flow composer (≤720px) ── */",
+      "@media (max-width: 720px) {",
+      "  /* 1) Composer seat sticky -> static: the seat hosts the input bar",
+      "     fallback AND confirmation takeovers (ask_user_question /",
+      "     approval / plan review); one rule frees them all together.",
+      "     Overlay mode is excluded: views like trajectory keep the",
+      "     official absolute seat positioning. */",
+      "  [data-conversation-scroll]:not(:has([data-conversation-composer-overlay])) > [data-composer-seat] {",
+      "    position: static !important;",
+      "    z-index: auto !important;",
+      "  }",
+      "  /* 2) Active-phase transcript stretch (flex-grow): with a short",
+      "     transcript the seat still lands flush with the viewport floor",
+      "     (visually identical to the stock docked bar); once the content",
+      "     exceeds one screen there is no free space left to distribute,",
+      "     the rule stops contributing, and the seat stays in the flow.",
+      "     hero/settling phases are unaffected. */",
+      "  [data-phase='active'] [data-conversation-scroll] > [data-slot='conversation.session'] {",
+      "    flex: 1 0 auto;",
+      "  }",
+      "  /* 3) Floating controls stop reserving height for the sticky seat:",
+      "     zeroing the variable drops the back-to-bottom button and the",
+      "     turn navigator back to the viewport floor (overrides the seat",
+      "     ResizeObserver's inline publication). Overlay mode excluded so",
+      "     trajectory's bottom-clearance is untouched. */",
+      "  [data-conversation-scroll]:not(:has([data-conversation-composer-overlay])) {",
+      "    --dsh-composer-height: 0px !important;",
+      "  }",
+      "}",
+    ].join("\n");
+
+    function apply(ctx) {
+      var tag = document.createElement("style");
+      tag.dataset.plugin = "dsh-mobile-flow";
+      tag.textContent = CSS;
+      document.head.append(tag);
+
+      ctx.effect(function () {
+        return function () {
+          tag.remove();
+        };
+      });
+    }
+
+    exports.apply = apply;
+    return module.exports;
+  }
+});

package/lib/index.js

@@ -0,0 +1,10 @@
+/**
+ * dsh-mobile-flow host half. Pure UI plugin: the empty apply exists so the
+ * plugin appears in the web profile's cordis.yml / Loader; the browser half
+ * ships via exports["./client"], discovered through the package.json
+ * dsh.client declaration.
+ */
+
+/** Host plugin body — no host-side behavior for this surface plugin. */
+function apply() {}
+export { apply }

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "dsh-mobile-flow",
+  "version": "0.1.0",
+  "description": "Mobile in-flow composer for the DeepSeek Harness Web UI: on narrow (≤720px) screens the input bar and AI confirmation cards scroll with the page instead of pinning to the viewport floor. Pure client-side CSS overlay.",
+  "license": "MIT",
+  "type": "module",
+  "main": "lib/index.js",
+  "exports": {
+    ".": "./lib/index.js",
+    "./client": "./lib/client.js",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib",
+    "cordis.patch.yml"
+  ],
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web"
+    }
+  },
+  "author": "roc <i@roc.im>",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/imroc/dsh-mobile-flow.git"
+  },
+  "homepage": "https://github.com/imroc/dsh-mobile-flow#readme",
+  "bugs": {
+    "url": "https://github.com/imroc/dsh-mobile-flow/issues"
+  },
+  "keywords": [
+    "deepseek-harness",
+    "dsh",
+    "dsh-plugin",
+    "mobile",
+    "web-ui",
+    "css"
+  ]
+}