dsh-generative-ui 0.0.0 → 0.0.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Muspi Merol
+
+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,90 @@
+# dsh-generative-ui
+
+[![npm](https://img.shields.io/npm/v/dsh-generative-ui)](https://www.npmjs.com/package/dsh-generative-ui)
+[![pkg.pr.new](https://pkg.pr.new/badge/CNSeniorious000/dsh-generative-ui)](https://pkg.pr.new/~/CNSeniorious000/dsh-generative-ui)
+[![MIT](https://img.shields.io/badge/license-MIT-blue)](./LICENSE)
+
+Generative UI for [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness): the agent answers with a live React interface instead of prose. It streams — the component renders while the model is still typing it.
+
+Two places it shows up:
+
+- **Inline** — a fenced ```` ```ui4a/tsx ```` block renders in place, between the paragraphs of the reply. Right for a chart, a form, a set of options to click, a calculation the reader will want to change a number in.
+- **Canvas** — a file at `ui4a/canvases/<id>.ui4a.tsx` opens in a panel beside the conversation and stays there across turns. Right for a tool the user will come back to.
+
+Generated code imports anything on npm (resolved from esm.sh at render time), shares the host's single React instance, and takes its colours from the app's own design tokens, so it follows the light/dark theme.
+
+The `ui4a` in that fence is the harness this implements — **UI for Agent**, from Mind Lab: rather than coaxing an agent into a fixed UI schema, let it write ordinary frontend code and have the runtime enforce the boundaries. The reasoning, and the benchmarks behind it, are in [UI4A: A Component-Native Harness for Generative UI](https://macaron.im/mindlab/research/ui4a-a-component-native-harness-for-generative-ui). This package is that harness wired into dsh's web client.
+
+## Install
+
+```sh
+dsh plugin --profile web add dsh-generative-ui
+```
+
+Every release is published from CI over OIDC, so the tarball carries npm provenance. For an
+unreleased commit there is a preview build of every push:
+
+```sh
+dsh plugin --profile web add https://pkg.pr.new/CNSeniorious000/dsh-generative-ui@main
+```
+
+And working on it locally, point the profile at your checkout — `lib/` is built by `prepare`, so
+the profile does not care that this package uses bun and dsh uses pnpm:
+
+```sh
+dsh plugin --profile web add link:/path/to/dsh-generative-ui
+```
+
+`dsh plugin` forwards to the profile's package manager, so any of these installs the package. Mounting it also takes one line in `~/.dsh/profiles/web/package.json` — the profile's bundle list is what dsh actually boots:
+
+```json
+{
+  "dsh": {
+    "profile": {
+      "bundles": [
+        "@deepseek-ai/dsh-base",
+        "@deepseek-ai/dsh-web-app",
+        "dsh-generative-ui"
+      ]
+    }
+  }
+}
+```
+
+Then restart `dsh web` — plugins are mounted at boot, and there is no hot-reload for adding one.
+
+**If nothing happens, check which agent preset the session is on first.** Under `minimal`
+(极简模式) the persona is declared `complete: true`, so nothing can append to the system prompt and
+the `skill` tool is not in the preset — the model is never told this format exists. Measured: 45
+characters of system prompt against 27524, and zero mentions of the fence. The rendering half still
+works, so a card you paste by hand renders; the model just will not write one. Use `standard`, or
+copy the preset and add `tool-skill` back.
+
+## How it works
+
+The package is one plugin with two halves, which is how dsh plugins reach the browser:
+
+| | |
+| --- | --- |
+| `lib/index.js` (node) | injects the system-prompt section, registers the `generative-ui` skill, serves the compiler wasm and canvas file reads over its own `webServer` routes |
+| `lib/client.js` (web) | claims `ui4a/tsx` code blocks in the transcript, compiles TSX in-browser, mounts the canvas panel |
+
+The model is taught in two layers, split by what each costs:
+
+- **`src/prompt.ts`** rides in every request, so it carries only the trigger, the fence syntax, the canvas path, and the colour tokens.
+- **`src/skill.ts`** is registered through `ctx.skills.register()` and loads only when the model reaches for it. It carries the judgement: whether the answer wants an interface at all, inline or canvas, how to frame and lay one out.
+
+That split is measured, not assumed — see [CLAUDE.md](./CLAUDE.md) §4.5 for the 40-prompt evaluation behind it.
+
+## Development
+
+```sh
+bun install
+bun run check     # lint + typecheck + build + smoke
+```
+
+`bun run build` bundles both halves with `Bun.build`. [CLAUDE.md](./CLAUDE.md) is the design document — it records the host constraints this plugin was built against, all of them found the hard way.
+
+## License
+
+MIT

package/cordis.patch.yml

@@ -0,0 +1,6 @@
+# Inserts one plugin row that mounts BOTH halves: the host side (serves the
+# @esm.sh/tsx wasm under /dsh-generative-ui/assets) and the browser side (the
+# client-modules node half scans dsh.client packages and serves lib/client.js).
+- insert:
+    - id: dsh-generative-ui
+      name: dsh-generative-ui