dsh-draw 0.1.2 → 0.2.1

package/CHANGELOG.md

@@ -5,6 +5,37 @@ All notable changes to this project are documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.2.1] - 2026-08-27
+
+### Fixed
+
+- Declare the web-client inject packages (`@deepseek-ai/dsh-client-connection`,
+  `@deepseek-ai/dsh-client-locale`, `@deepseek-ai/dsh-client-runtime`,
+  `@deepseek-ai/dsh-client-ui-settings`, `@deepseek-ai/dsh-client-ui-slots`,
+  `@deepseek-ai/dsh-client-ui-tool`) as optional peerDependencies so the
+  bundle composition is explicit and standalone installs stay clean.
+
+## [0.2.0] - 2026-08-26
+
+### Added
+
+- Pluggable engine provider seam (Replicate / fal.ai).
+
+## [0.1.3] - 2026-08-23
+
+### Added
+
+- Presenter pure-function suite (`tests/present.spec.ts`, 11 tests): `presentDrawResult` and `presentDrawPanel` are pinned directly on their arguments — settled/error/foreign/null-call-head blocks, meta fallbacks, regenerate-args parsing, engine-row projection, and the cooldown flag.
+
+### Changed
+
+- `presentDrawPanel` now takes an optional `now` clock (default `Date.now`) so the cooldown flag is a pure function of its inputs and testable without fake timers; the `image_generate` tool surface and the settings tab are unchanged.
+
+### Fixed
+
+- The five-language README "Development" section reported a stale `77 tests, 11 suites`; it now matches the actual `107 tests, 16 test files`.
+- `src/version.ts` referenced a non-existent `tests/version.spec.ts`; the comment now names the real tripwire (`tests/session-events.spec.ts`).
+
 ## [0.1.2] - 2026-08-22
 
 ### Changed

package/README.es.md

@@ -139,7 +139,7 @@ Ejemplo de sobrescritura en el parche de tu perfil:
 pnpm install        # node ^22.19 || >=24
 pnpm run typecheck  # tsc: src + tests contra el checkout local del harness
 pnpm run typecheck:ci  # tsc contra las caras publicadas 0.1.1-rc.2 (sin paths)
-pnpm test           # vitest: 77 tests, 11 suites (transporte guionado, Context/Session/ToolRuntime reales)
+pnpm test           # vitest: 107 tests, 16 archivos de prueba (transporte guionado, Context/Session/ToolRuntime reales)
 pnpm run build      # declaraciones tsc + bundles tsdown (lib/)
 pnpm run verify:self-contained  # las especificaciones de dependencias resuelven desde el registry
 pnpm run verify:artifacts       # cara ESM host + manifiesto typert + bundle de navegador + archivos de configuración
@@ -153,6 +153,7 @@ pnpm pack           # el tarball publicado
 ## Contributors
 
 - [@PerryLink](https://github.com/PerryLink) — creador y mantenedor: enrutador de motores, drawer, contabilidad de cuota, vocabulario wire de Typert, mitad de navegador y la documentación en cinco idiomas.
+- [@Mohei-Muun](https://github.com/Mohei-Muun) — informó del fallo de carga del registro de sesión `draw/generated` en hosts rc.7 ([#2](https://github.com/PerryLink/dsh-draw/issues/2)), que condujo a la puerta de eventos adaptativa.
 
 ## PerryLink DSH Plugin Family
 

package/README.hi.md

@@ -139,7 +139,7 @@ dsh --profile web --dump-config | grep -A2 'id: dsh-draw'
 pnpm install        # node ^22.19 || >=24
 pnpm run typecheck  # tsc: src + tests स्थानीय हार्नेस चेकआउट के विरुद्ध
 pnpm run typecheck:ci  # tsc प्रकाशित 0.1.1-rc.2 फ़ेस के विरुद्ध (बिना paths)
-pnpm test           # vitest: 77 टेस्ट, 11 सुइट (स्क्रिप्टेड ट्रांसपोर्ट, वास्तविक Context/Session/ToolRuntime)
+pnpm test           # vitest: 107 टेस्ट, 16 टेस्ट फ़ाइलें (स्क्रिप्टेड ट्रांसपोर्ट, वास्तविक Context/Session/ToolRuntime)
 pnpm run build      # tsc घोषणाएँ + tsdown बंडल (lib/)
 pnpm run verify:self-contained  # निर्भरता स्पेक registry से हल होती हैं
 pnpm run verify:artifacts       # host ESM फ़ेस + typert मैनिफ़ेस्ट + ब्राउज़र बंडल + कॉन्फ़िग फ़ाइलें
@@ -153,6 +153,7 @@ pnpm pack           # प्रकाशित tarball
 ## Contributors
 
 - [@PerryLink](https://github.com/PerryLink) — निर्माता और मेंटेनर: इंजन रूटर, drawer, कोटा लेखा, Typert wire शब्दावली, ब्राउज़र आधा और पाँच-भाषा दस्तावेज़।
+- [@Mohei-Muun](https://github.com/Mohei-Muun) — rc.7 होस्ट पर `draw/generated` सत्र-लॉग लोड विफलता की सूचना दी ([#2](https://github.com/PerryLink/dsh-draw/issues/2)), जिससे अनुकूली इवेंट गेट बना।
 
 ## PerryLink DSH Plugin Family
 

package/README.md

@@ -85,7 +85,7 @@ All tunables are Schemastery `Config` fields (changeable from cordis.yml). An id
 
 | Key | Default | Meaning |
 |---|---|---|
-| `engines` | OpenAI + CogView presets | Ordered engine chain, walked top-down with fallback; each entry: `id`, `baseUrl` (no credentials), `model`, `apiKeyRef` (env-var name), `enabled`, `sizeMap`, `qualitySupported`, `styleSupported`, `responseFormat` (`b64_json`/`url`), `imageMediaType` |
+| `engines` | OpenAI + CogView presets | Ordered engine chain, walked top-down with fallback; each entry: `id`, `baseUrl` (no credentials), `model`, `apiKeyRef` (env-var name), `provider` (`openai`/`replicate`/`fal`, default `openai`), `enabled`, `sizeMap`, `qualitySupported`, `styleSupported`, `responseFormat` (`b64_json`/`url`), `imageMediaType` |
 | `defaultEngine` | `openai` | Engine id the router prefers; must name a configured engine |
 | `requestTimeoutMs` | `120000` | Per-generation HTTP timeout (1000..600000) |
 | `maxImagesPerCall` | `4` | Cap on images one call may produce (1..10) |
@@ -130,7 +130,7 @@ Example override in your profile patch:
 ## Known limitations
 
 - **Image models only.** No video, audio, or edit endpoints; no vision understanding.
-- **Engine compatibility.** Engines must speak the OpenAI `POST /images/generations` shape (base64 or URL delivery); provider-specific extras are out of scope.
+- **Engine compatibility.** Three vocabularies are supported through the provider seam: `openai` (the `POST /images/generations` shape), `replicate` (prediction create + poll), and `fal` (the `fal.run` queue). Provider-specific extras beyond `prompt`/size/count (e.g. seed, scheduler) are out of scope.
 - **Cost awareness is structural.** The plugin counts calls and bytes but does not know engine pricing — pair with `dsh-budget` for cost governance.
 - **Quota durability on rc.6/rc.7.** On hosts whose session log cannot carry `draw/generated` (static event whitelist, no `ignorable` envelope), quota stays exact for the live session from the in-memory fallback ledger but resets on restart; durable accounting resumes on hosts with a plugin event surface.
 
@@ -140,7 +140,7 @@ Example override in your profile patch:
 pnpm install        # node ^22.19 || >=24
 pnpm run typecheck  # tsc: src + tests against the local harness checkout
 pnpm run typecheck:ci  # tsc against the published 0.1.1-rc.2 faces (no paths)
-pnpm test           # vitest: 77 tests, 11 suites (scripted transport, real Context/Session/ToolRuntime)
+pnpm test           # vitest: 107 tests, 16 test files (scripted transport, real Context/Session/ToolRuntime)
 pnpm run build      # tsc declarations + tsdown bundles (lib/)
 pnpm run verify:self-contained  # dependency specs resolve from the registry
 pnpm run verify:artifacts       # host ESM face + typert manifest + browser bundle + config files
@@ -154,6 +154,7 @@ pnpm pack           # the published tarball
 ## Contributors
 
 - [@PerryLink](https://github.com/PerryLink) — creator and maintainer: engine router, drawer, quota accounting, Typert wire vocabulary, browser half, and the five-language docs.
+- [@Mohei-Muun](https://github.com/Mohei-Muun) — reported the `draw/generated` session-log unload bug on rc.7 hosts ([#2](https://github.com/PerryLink/dsh-draw/issues/2)), which led to the adaptive event gate.
 
 ## PerryLink DSH Plugin Family
 

package/README.pt.md

@@ -139,7 +139,7 @@ Exemplo de sobrescrita no patch do seu perfil:
 pnpm install        # node ^22.19 || >=24
 pnpm run typecheck  # tsc: src + tests contra o checkout local do harness
 pnpm run typecheck:ci  # tsc contra as faces publicadas 0.1.1-rc.2 (sem paths)
-pnpm test           # vitest: 77 testes, 11 suítes (transporte roteirizado, Context/Session/ToolRuntime reais)
+pnpm test           # vitest: 107 testes, 16 arquivos de teste (transporte roteirizado, Context/Session/ToolRuntime reais)
 pnpm run build      # declarações tsc + bundles tsdown (lib/)
 pnpm run verify:self-contained  # as especificações de dependências resolvem pelo registry
 pnpm run verify:artifacts       # face ESM host + manifesto typert + bundle de navegador + arquivos de configuração
@@ -153,6 +153,7 @@ pnpm pack           # o tarball publicado
 ## Contributors
 
 - [@PerryLink](https://github.com/PerryLink) — criador e mantenedor: roteador de motores, drawer, contabilidade de cota, vocabulário wire do Typert, metade de navegador e a documentação em cinco idiomas.
+- [@Mohei-Muun](https://github.com/Mohei-Muun) — relatou a falha de carregamento do log de sessão `draw/generated` em hosts rc.7 ([#2](https://github.com/PerryLink/dsh-draw/issues/2)), que levou ao gate de eventos adaptativo.
 
 ## PerryLink DSH Plugin Family
 

package/README.zh.md

@@ -139,7 +139,7 @@ profile patch 中的覆盖示例：
 pnpm install        # node ^22.19 || >=24
 pnpm run typecheck  # tsc：src + tests，对照本地 harness checkout
 pnpm run typecheck:ci  # tsc：对照已发布的 0.1.1-rc.2 类型（无 paths）
-pnpm test           # vitest：77 个测试、11 个套件（scripted 传输、真实 Context/Session/ToolRuntime）
+pnpm test           # vitest：107 个测试、16 个测试文件（scripted 传输、真实 Context/Session/ToolRuntime）
 pnpm run build      # tsc 声明 + tsdown 打包（lib/）
 pnpm run verify:self-contained  # 依赖声明全部来自 registry
 pnpm run verify:artifacts       # host ESM 面 + typert manifest + 浏览器包 + 配置文件
@@ -153,6 +153,7 @@ pnpm pack           # 发布用 tarball
 ## Contributors
 
 - [@PerryLink](https://github.com/PerryLink) —— 创建者与维护者：引擎路由、drawer、配额记账、Typert wire 词汇、浏览器半与五语文档。
+- [@Mohei-Muun](https://github.com/Mohei-Muun) —— 报告了 rc.7 主机上 `draw/generated` 会话日志导致会话无法重载的缺陷（[#2](https://github.com/PerryLink/dsh-draw/issues/2)），推动了自适应事件门控的实现。
 
 ## PerryLink DSH Plugin Family
 

package/cordis.patch.yml

@@ -8,12 +8,15 @@
       config:
         # Ordered engine chain; the router walks it top-down and falls back on
         # failure. apiKeyRef names an environment variable (credential
-        # reference) — never put a literal key here.
+        # reference) — never put a literal key here. `provider` selects the
+        # request/response vocabulary: openai (OpenAI-compatible images API),
+        # replicate (prediction polling), or fal (fal.run queue).
         engines:
           - id: openai
             baseUrl: https://api.openai.com/v1
             model: gpt-image-1
             apiKeyRef: OPENAI_API_KEY
+            provider: openai
             enabled: true
             sizeMap: { square: 1024x1024, landscape: 1536x1024, portrait: 1024x1536, auto: auto }
             qualitySupported: true
@@ -24,6 +27,7 @@
             baseUrl: https://open.bigmodel.cn/api/paas/v4
             model: cogview-3-flash
             apiKeyRef: ZHIPU_API_KEY
+            provider: openai
             enabled: true
             sizeMap: { square: 1024x1024, landscape: 1344x768, portrait: 768x1344, auto: 1024x1024 }
             qualitySupported: false

package/lib/client.js

@@ -54,9 +54,11 @@ window.__ModuleLoader__.load({
 		* Project the panel snapshot onto the settings row model.
 		*
 		* @param snapshot - the `draw/status` wire snapshot.
+		* @param now - clock override for the cooldown flag (default {@link Date.now});
+		*   injected so the presenter stays a pure function of its inputs.
 		* @returns the presented panel model.
 		*/
-		function presentDrawPanel(snapshot) {
+		function presentDrawPanel(snapshot, now = Date.now) {
 			return {
 				pluginVersion: snapshot.pluginVersion,
 				engines: snapshot.engines.map((engine) => ({
@@ -70,7 +72,7 @@ window.__ModuleLoader__.load({
 					...engine.credential.source !== void 0 ? { credentialSource: engine.credential.source } : {},
 					credentialWritable: engine.credential.writable,
 					consecutiveFailures: engine.health.consecutiveFailures,
-					coolingDown: engine.health.cooldownUntil !== null && engine.health.cooldownUntil > Date.now(),
+					coolingDown: engine.health.cooldownUntil !== null && engine.health.cooldownUntil > now(),
 					lastError: engine.health.lastError
 				})),
 				quota: {