@matamt-dbg/dsh-studio 0.0.0-stage → 0.2.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 matamt-dbg
+
+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,90 @@
-# Temporary Holding Version
+<p align="center">
+  <img src="https://raw.githubusercontent.com/matamt-dbg/dsh-studio/main/docs/images/icon.png" width="96" height="96" alt="DSH Studio icon">
+</p>
 
-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.
+<h1 align="center">DSH Studio</h1>
+
+<p align="center"><b>See it, tune it, ship it — agent presets for DeepSeek Harness, without editing YAML.</b></p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/@matamt-dbg/dsh-studio"><img src="https://img.shields.io/npm/v/@matamt-dbg/dsh-studio" alt="npm version"></a>
+  <img src="https://img.shields.io/badge/DSH-0.2.0--rc.2%20%7C%200.2.1--alpha.2-4f6bff" alt="Supported DSH versions">
+  <img src="https://img.shields.io/badge/license-MIT-blue" alt="MIT license">
+</p>
+
+DSH Studio is a plugin for [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) that turns preset building into a visual workflow in the web GUI.
+
+## Why
+
+DeepSeek Harness exposes a lot to configure — which tools an agent gets, how each tool is described to the model, the system prompt sections, plugin settings, and how work is delegated to subagents. But all of it only takes effect through an **agent preset**, and building one by hand means editing composition files without seeing what the model will actually receive.
+
+Studio closes that loop:
+
+- **Make the configuration visible.** Pick tools, edit instructions and tool descriptions, and override plugin settings on one screen.
+- **Check before you run.** Preview the exact system prompt and tool schemas a preset produces, without starting an agent.
+- **Apply in one click.** Register the preset with DSH and choose it for a new session.
+
+## Direction: less noise, better use of DSH
+
+Studio also ships **Optimized**, a starting preset built on a simple idea: an agent works better when it sees fewer, clearer tools and knows how DSH expects them to be used.
+
+Compared with the stock setup, Optimized
+
+- **trims the tool surface** to 22 everyday tools, dropping goal/todo tracking, runtime introspection and plugin management tools that rarely help a coding task (they stay available in Studio Master);
+- **folds delegation into one tool**, `subagent_role`, instead of several generic subagent tools;
+- **adds working instructions and tunes tool descriptions** so the model batches independent reads, waits for background work instead of polling it, collects the jobs it starts, and keeps checks proportional before reporting.
+
+In our early internal benchmarks, this preset performed noticeably better than DSH's stock `standard` preset.
+
+Optimized is tuned for **coding-agent work**. It is a starting point, not a fixed recipe: copy it and adjust the tools, instructions, tool descriptions and plugin Configs to fit your own tasks. See [Adapt Optimized to your work](https://github.com/matamt-dbg/dsh-studio/blob/main/docs/guide.md#adapt-optimized-to-your-work).
+
+> DSH Studio is a community project. It is not affiliated with, endorsed by, or supported by DeepSeek.
+
+## Install
+
+Requires DSH `0.2.0-rc.2` or `0.2.1-alpha.2`.
+
+```sh
+dsh plugin --profile web add @matamt-dbg/dsh-studio
+```
+
+Restart the web GUI, then open **DSH Studio** from the sidebar.
+
+## Features
+
+![Preset list](https://raw.githubusercontent.com/matamt-dbg/dsh-studio/main/docs/images/en/preset-list.png)
+
+- **Presets** — a read-only *Studio Master* with every available tool, a locked built-in *Optimized* preset (22 everyday tools) to copy from, and your own presets. Edit, copy, delete, apply to DSH, or unapply.
+- **Prompts & tools** — edit persona and additional instructions, pick tools (or whole built-in tool sets), and rewrite the descriptions the model sees for each tool and parameter.
+- **Prompt preview** — see the exact system prompt and tool schemas a preset produces, without starting an agent.
+- **Execution settings** — override plugin configuration for one preset only.
+- **Subagents** — DSH's generic subagent tools become a single `subagent_role` tool. Define roles with their own model, reasoning effort, fresh or fork start, and persona; with no roles, `subagent_role` starts a child that inherits the parent's settings.
+
+| Prompts & tools | Prompt preview | Subagent roles |
+|---|---|---|
+| ![Tools](https://raw.githubusercontent.com/matamt-dbg/dsh-studio/main/docs/images/en/tools.png) | ![Preview](https://raw.githubusercontent.com/matamt-dbg/dsh-studio/main/docs/images/en/prompt-preview.png) | ![Roles](https://raw.githubusercontent.com/matamt-dbg/dsh-studio/main/docs/images/en/role-editor.png) |
+
+**User guide: [English](https://github.com/matamt-dbg/dsh-studio/blob/main/docs/guide.md) · [한국어](https://github.com/matamt-dbg/dsh-studio/blob/main/docs/guide.ko.md)**
+
+## Quick start
+
+1. Open **DSH Studio** and select **Create copy** on *Optimized* (the built-in itself is locked).
+2. Adjust instructions, tools, execution settings and subagent roles, then **Save preset**.
+3. In **Preset list**, select **Apply to DSH**.
+4. Start a new session and choose your preset in DSH's preset picker.
+
+Presets are stored per profile in `studio-data/`. Applying a preset registers a Studio-owned DSH agent preset; it never edits other presets or the profile's packages.
+
+## Development
+
+```sh
+pnpm install
+pnpm test        # typecheck, build, tests
+node pack.mjs    # writes dist/matamt-dbg-dsh-studio-<version>.tgz
+```
+
+Please report bugs and requests in [Issues](https://github.com/matamt-dbg/dsh-studio/issues).
+
+## License
+
+MIT