banso-dsh-web 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 tindada
+
+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

@@ -1,3 +1,17 @@
-# Temporary Holding Version
+# Banso 最小 Web 聊天
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+`banso-dsh-web` 是追加在 `banso-dsh` 后的 Web bundle。它在自己的 patch 中停用 SDK 启动和 stdio 服务，不修改基础包或业务包；复用 DSH `0.2.0-rc.2` 的通信、会话对象、持久化和前端启动壳。
+
+本包组合 `banso-dsh-ui` 提供 Web 聊天。安装、密钥配置、启动和端口设置见 [Web 聊天使用说明](https://github.com/Tindada/banso-dsh/blob/main/README.md#web-聊天源码安装)，界面行为和限制见 [UI 说明](https://github.com/Tindada/banso-dsh/blob/main/packages/ui/README.md#展示与限制)。
+
+修改 profile 配置后需重启服务。
+
+## 组合和存储
+
+- profile 中的 bundle 顺序必须是 `banso-dsh`、`banso-dsh-web`，不要同时加载 `banso-dsh-base` 或官方 `dsh-web-app`。
+- 会话沿用 `DSH_HOME/sessions-banso-base`（默认 `~/.dsh/sessions-banso-base`）。工作区元数据和附件放在 `DSH_HOME/banso-web/`。
+- `attachment-local`、`file-upload`、`commands`、文件系统及工作区存储来自官方会话接口的依赖，即使前端不显示这些功能也需要加载。
+- `ui-renderer` 负责根页面渲染；`ui-session` 只提供 renderer 所需的会话作用域适配；`banso-dsh-ui` 是唯一页面。未加载官方 chat、layout、sidebar 等界面。
+- 网页直接连接 Node.js DSH 服务，不经过 Python SDK；SDK 原 profile 继续使用原有组合。
+
+构建和浏览器集成验证见 [开发文档](https://github.com/Tindada/banso-dsh/blob/main/docs/development.md)。

package/cordis.patch.yml

@@ -0,0 +1,91 @@
+# Apply after banso-dsh. SDK configuration and business packages stay unchanged.
+- id: sdk-app-startup
+  disabled: true
+- id: sdk-jsonrpc-server
+  disabled: true
+# Config patches replace the whole object: preserve Jina and disabled native fetch.
+- id: web
+  config:
+    searchProvider: deepseek-official
+    fetchProvider: jina
+- id: tool-web
+  config:
+    search: true
+    fetch: false
+    searchTimeoutMs: 60000
+- insert:
+    - id: web-search-deepseek
+      name: '@deepseek-ai/dsh-web-search-deepseek'
+      config:
+        apiKeyEnv: DEEPSEEK_API_KEY
+    - id: banso-web-startup
+      name: banso-dsh-web
+    - id: host-webserver
+      name: "@deepseek-ai/dsh-host-webserver"
+      inject: [bansoWebStartup]
+      config:
+        host: 127.0.0.1
+        port: !!js ctx.bansoWebStartup.port
+    - id: host-frontend-static
+      name: "@deepseek-ai/dsh-host-frontend-static"
+      inject: [bansoWebStartup]
+      config:
+        distIndex: !!js ctx.bansoWebStartup.distIndex
+    - id: client-modules
+      name: "@deepseek-ai/dsh-client-modules"
+    - id: client-connection
+      name: "@deepseek-ai/dsh-client-connection"
+    - id: typert-registry
+      name: "@deepseek-ai/dsh-typert-registry"
+    - id: typert-loader
+      name: "@deepseek-ai/dsh-typert-loader"
+    - id: api-gateway
+      name: "@deepseek-ai/dsh-api-gateway"
+    - id: api-remotes
+      name: "@deepseek-ai/dsh-api-remotes"
+    - id: api-session-controller
+      name: "@deepseek-ai/dsh-api-session-controller"
+      config:
+        nativeOpen: false
+    - id: credentials-local
+      name: "@deepseek-ai/dsh-credentials-local"
+    - id: agent-default-model
+      name: "@deepseek-ai/dsh-agent-default-model"
+      config:
+        provider: deepseek-official
+        model: deepseek-flash
+    - id: session-query-sqlite
+      name: "@deepseek-ai/dsh-session-query-sqlite"
+      config:
+        path: ':memory:'
+        openAt: never
+    - id: attachment-local
+      name: "@deepseek-ai/dsh-attachment-local"
+      config:
+        dshHome: !!js dshHomePath('banso-web')
+    - id: client-file-upload
+      name: "@deepseek-ai/dsh-client-file-upload"
+    - id: commands
+      name: "@deepseek-ai/dsh-commands"
+    - id: fs-local
+      name: "@deepseek-ai/dsh-fs-local"
+    - id: file-reference-local
+      name: "@deepseek-ai/dsh-file-reference-local"
+    - id: workspace
+      name: "@deepseek-ai/dsh-workspace"
+    - id: storage
+      name: "@deepseek-ai/dsh-storage"
+    - id: storage-json
+      name: "@deepseek-ai/dsh-storage-json"
+      config:
+        root: !!js dshHomePath('banso-web/storages')
+    - id: storage-domain
+      name: "@deepseek-ai/dsh-storage-domain"
+      config:
+        backend: json
+    - id: client-ui-renderer
+      name: "@deepseek-ai/dsh-client-ui-renderer"
+    - id: client-ui-session
+      name: "@deepseek-ai/dsh-client-ui-session"
+    - id: banso-ui
+      name: banso-dsh-ui

package/package.json

@@ -1,6 +1,63 @@
 {
   "name": "banso-dsh-web",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "type": "module",
+  "license": "MIT",
+  "exports": {
+    ".": "./src/index.js",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "src",
+    "cordis.patch.yml",
+    "README.md"
+  ],
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    }
+  },
+  "dependencies": {
+    "banso-dsh": "0.1.1",
+    "banso-dsh-ui": "0.1.0",
+    "@deepseek-ai/dsh-host-webserver": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-host-frontend-static": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-client-modules": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-client-connection": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-typert-registry": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-typert-loader": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-api-gateway": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-api-remotes": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-api-session-controller": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-credentials-local": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-agent-default-model": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-session-query-sqlite": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-attachment-local": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-client-file-upload": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-commands": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-fs-local": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-file-reference-local": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-workspace": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-storage": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-storage-json": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-storage-domain": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-client-ui-renderer": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-web-frontend": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-cmdline": "0.2.0-rc.2",
+    "commander": "^15.0.0",
+    "@deepseek-ai/dsh-client-ui-session": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-web-search-deepseek": "0.2.0-rc.2"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.4"
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "^4.0.4",
+    "@deepseek-ai/dsh": "0.2.0-rc.2",
+    "playwright": "^1.49.0"
+  },
+  "description": "Banso research web bundle for DeepSeek Harness",
+  "scripts": {
+    "test": "node --test tests/*.test.mjs"
+  }
 }

package/src/index.js

@@ -0,0 +1,24 @@
+import { createRequire } from 'node:module';
+import { Command } from 'commander';
+import { parseCmdline } from '@deepseek-ai/dsh-cmdline';
+
+export const inject = ['cmdlineArgs'];
+export function apply(ctx) {
+  const program = new Command().name('dsh --profile banso-web')
+    .description('Serve the minimal Banso chat UI on localhost.')
+    .option('--port <port>', 'localhost port (0 chooses a free port)', '3080');
+  program.action(() => {
+    const value = program.opts().port;
+    if (!/^\d+$/.test(value) || Number(value) > 65535) program.error('port must be an integer from 0 to 65535');
+    const require = createRequire(import.meta.url);
+    ctx.provide('bansoWebStartup', {
+      port: Number(value),
+      distIndex: require.resolve('@deepseek-ai/dsh-web-frontend/dist/index.html'),
+    });
+    ctx.inject(['webServer', 'connection'], child => {
+      const report = () => console.log(`Banso Web: ${child.connection.authenticatedUrl(`http://127.0.0.1:${child.webServer.port}`)}`);
+      if (ctx.appReady) child.effect(() => ctx.appReady.onReady(report));
+    });
+  });
+  parseCmdline(ctx, program);
+}