@goodandready/dsh-moa 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 GooDAnDReaDY
+
+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,120 @@
+# @goodandready/dsh-moa
+
+> **Mixture of Agents (MoA)** plugin for **DeepSeek Harness** adding the `/moa <prompt>` slash command.
+
+---
+
+## Overview
+
+`dsh-moa` introduces the **Mixture of Agents** architecture to DeepSeek Harness, inspired by Hermes Agent and OpenClaw.
+
+Instead of routing a complex problem to a single language model, `dsh-moa` executes a collaborative multi-phase pipeline:
+1. **Interactive Requirement Refinement (Adaptive):** For broad or underspecified prompts (e.g. `/moa build a calculator`), advisor models formulate clarifying options and the judge synthesizes a structured 2-4 question questionnaire before generating code.
+2. **Candidate Proposers (Advisors) & File Isolation:** Multiple independent models query the prompt concurrently to produce diverse, creative, and distinct solutions. Each candidate's generated files are isolated under `.moa/candidate-N/`.
+3. **Aggregator (Judge / Synthesizer) & Promotion:** A frontier reasoning model critically compares all candidate solutions, chooses the best implementation via a machine marker (`WINNER_CANDIDATE_INDEX: N`), and promotes the winner's files directly into the project root directory while cleaning up temporary sandboxes.
+4. **Live Canvas Integration:** If web files (HTML, JSX, etc.) are generated, `dsh-moa` automatically notifies `dsh-live-canvas` via its REST API, enabling instant 1-click visual previewing.
+5. **Token-Efficient Code Summarization:** Chat responses present clean architectural summaries, file listings, and interactive links without dumping thousands of lines of raw code into the chat history.
+6. **One-Shot Session Model Restoration:** The slash command operates strictly as a one-shot turn modifier. As soon as the synthesis completes (even on errors), the session automatically and cleanly reverts to the user's primary working model.
+
+---
+
+## Features
+
+- **Slash Command Integration (`/moa`):** Built-in autocompletion in the DeepSeek Harness web composer via `inputTriggers`.
+- **Adaptive Questionnaire Gate:** Detects broad requests and interactively asks clarifying questions with recommended answers.
+- **Parallel Fan-out with Live Heartbeats:** Fast concurrent model evaluation with real-time progress indicators (`⏳ [Ns] Processing...`, per-model completion badges).
+- **Disk-Level Workspace Isolation:** Candidates create real files on disk in temporary workspaces; the judge picks the winning candidate and promotes files to the workspace.
+- **Live Canvas 1-Click Integration:** Automatically creates sandbox sessions in `@goodandready/dsh-live-canvas` for generated web applications.
+- **Token-Saving Chat Output:** Strips voluminous raw code dumps in chat messages in favor of compact file listings and markdown summaries.
+- **Advisory Context Isolation:** Tool dumps and bulky system prompts are stripped from candidate advisor context, preventing prompt bloat and "missing tools" refusals.
+- **DSH Native Settings Card:** Collapsible plugin card under `Settings → Plugins → Mixture of Agents` built using native `--dsw-alias-*` theme tokens.
+- **Named Presets:** Configure custom MoA presets such as `default`, `code-review`, or `deep-reasoning`.
+
+---
+
+## Usage
+
+### In Composer
+
+Type `/moa` in the DeepSeek Harness chat input:
+
+```text
+/moa explain the Raft consensus algorithm with state transitions
+```
+
+Or target a specific configured preset:
+
+```text
+/moa deep-reasoning analyze this concurrency bottleneck
+```
+
+To build a project with real files:
+
+```text
+/moa build an interactive scientific calculator in HTML/CSS/JS
+```
+
+---
+
+## Configuration
+
+In **Settings → Plugins → Mixture of Agents**:
+
+| Field | Description | Default |
+|---|---|---|
+| **Default Preset** | Name of the default preset applied when no preset name is specified | `default` |
+| **Proposer Models** | Array of `{ provider, model }` candidates queried in parallel | `deepseek:deepseek-chat`, `openai:gpt-4o` |
+| **Aggregator Model** | Leading judge model synthesizing candidate responses | `anthropic:claude-3-7-sonnet` |
+| **Reference Temperature** | Sampling temperature for proposer candidates | `0.6` |
+| **Aggregator Temperature** | Sampling temperature for the synthesizer model | `0.4` |
+| **Max Tokens** | Maximum tokens for generation | `4096` |
+
+---
+
+## Architecture
+
+```
+                       +-------------------------------------------------------+
+                       |              User Input in DSH Composer               |
+                       |             "/moa <complex problem prompt>"           |
+                       +-------------------------------------------------------+
+                                                  |
+                                                  v
+                       +-------------------------------------------------------+
+                       |             Client Trigger (lib/client.js)            |
+                       |       Autocomplete via inputTriggers, sends to agent  |
+                       +-------------------------------------------------------+
+                                                  |
+                                                  v
+                       +-------------------------------------------------------+
+                       |            Host Interceptor (lib/index.js)            |
+                       |  1. Records initial session model (originalModel)     |
+                       |  2. Cleans context for advisory advisors              |
+                       +-------------------------------------------------------+
+                                                  |
+                                                  v
+                       +-------------------------------------------------------+
+                       |             MoA Runner (lib/moa-runner.js)            |
+                       |  1. Evaluates broadness -> Questionnaire or Sandbox   |
+                       |  2. Parallel fan-out -> writes .moa/candidate-N/      |
+                       |  3. Judge evaluation -> WINNER_CANDIDATE_INDEX        |
+                       |  4. File Promotion -> moves winner files to root      |
+                       |  5. Live Canvas API -> registers visual preview       |
+                       +-------------------------------------------------------+
+```
+
+---
+
+## Testing
+
+Run unit and contract test suite without network dependencies:
+
+```bash
+node --test test/*.test.mjs
+```
+
+---
+
+## License
+
+MIT © [GooDAnDReaDY](https://github.com/GooDAnDReaDY)

package/README.ru.md

@@ -0,0 +1,83 @@
+# @goodandready/dsh-moa
+
+> Плагин **Mixture of Agents (MoA)** для **DeepSeek Harness**, добавляющий слэш-команду `/moa <prompt>`.
+
+---
+
+## Обзор
+
+`dsh-moa` реализует архитектуру **Mixture of Agents** в DeepSeek Harness по образцу передовых ансамблевых систем (Hermes Agent, OpenClaw).
+
+Вместо отправки сложной инженерной или логической задачи одной модели, `dsh-moa` выполняет гибкий многофазный процесс:
+1. **Интерактивное уточнение требований (Адаптивный опросник):** При широких или неполных запросах (например, `/moa создай калькулятор`) советники формируют варианты реализации, а судья синтезирует компактный опросник из 2–4 вопросов с вариантами ответов до запуска написания кода.
+2. **Модели-кандидаты (Proposers / Advisors) и изолированные воркспейсы:** Несколько независимых моделей параллельно анализируют задачу и генерируют файлы в изолированных песочницах `.moa/candidate-N/`.
+3. **Модель-агрегатор (Judge / Synthesizer) и промоция файлов:** Мощная рассуждающая модель сопоставляет решения кандидатов, определяет победителя машинным маркером (`WINNER_CANDIDATE_INDEX: N`), переносит созданные файлы победителя напрямую в корень проекта и удаляет временные директории.
+4. **Интеграция с Live Canvas:** При создании веб-файлов (`index.html` и др.) плагин автоматически регистрирует их в сервисе `@goodandready/dsh-live-canvas` и предоставляет ссылки для мгновенного запуска предпросмотра в один клик.
+5. **Экономия токенов при выводе в чат:** Большие блоки исходного кода заменяются компактными плашками с описанием файлов, сохраняя контекст чата чистым и лаконичным.
+6. **One-Shot восстановление модели:** Команда `/moa` действует строго на один ход. Сразу после завершения ответа сессия автоматически и гарантированно возвращается к исходной рабочей модели.
+
+---
+
+## Возможности
+
+- **Интеграция слэш-команды (`/moa`):** Автодополнение в поле ввода чата DeepSeek Harness через сервис `inputTriggers`.
+- **Живые индикаторы прогресса (Heartbeats):** Отображение статуса в реальном времени (`⏳ [Ns] Идёт обработка...`, отметки о завершении генерации каждой моделью).
+- **Дисковая изоляция кандидатов:** Реальное создание файлов на диске и перенос лучшего решения в корень проекта.
+- **Интеграция с Live Canvas:** Автоматическое открытие созданных интерфейсов в плагине Live Canvas.
+- **Параллельный опрос (Fan-out):** Конкурентное выполнение запросов с graceful degradation.
+- **Изолированный контекст советников:** Очистка истории от системных промптов агента и дампов инструментов.
+- **Нативная карточка настроек DSH:** Карточка в разделе «Настройки → Плагины → Mixture of Agents», использующая системные токены темы `--dsw-alias-*`.
+- **Именованные пресеты:** Поддержка нескольких конфигураций моделей (`default`, `code-review`, `deep-reasoning`).
+
+---
+
+## Использование
+
+В поле ввода чата DeepSeek Harness:
+
+```text
+/moa напиши архитектуру распределённого кэша с защитой от dog-piling
+```
+
+Или с указанием конкретного пресета:
+
+```text
+/moa deep-reasoning найди скрытые гонки данных в этом алгоритме
+```
+
+Создание проекта с реальными файлами:
+
+```text
+/moa сделай интерактивный калькулятор на HTML, CSS и JS
+```
+
+---
+
+## Настройки
+
+В разделе **Настройки → Плагины → Mixture of Agents**:
+
+| Параметр | Описание | По умолчанию |
+|---|---|---|
+| **Основной пресет** | Имя пресета по умолчанию при вызове `/moa <prompt>` | `default` |
+| **Модели-кандидаты** | Массив `{ provider, model }`, опрашиваемых параллельно | `deepseek:deepseek-chat`, `openai:gpt-4o` |
+| **Ведущая модель (судья)** | Модель-агрегатор, синтезирующая финальный ответ | `anthropic:claude-3-7-sonnet` |
+| **Температура кандидатов** | Степень креативности кандидатов | `0.6` |
+| **Температура судьи** | Степень точности синтезатора | `0.4` |
+| **Максимум токенов** | Лимит длины ответа | `4096` |
+
+---
+
+## Тестирование
+
+Запуск модульных и контрактных тестов:
+
+```bash
+node --test test/*.test.mjs
+```
+
+---
+
+## Лицензия
+
+MIT © [GooDAnDReaDY](https://github.com/GooDAnDReaDY)

package/cordis.patch.yml

@@ -0,0 +1,4 @@
+- insert:
+    - id: dsh-moa
+      name: '@goodandready/dsh-moa'
+      config: {}