dsh-motion-ui 0.5.4 → 0.5.6

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # DSH Motion UI
 
+## 0.5.6 — 2026-10-10
+
+- Disable tool-time UI preview and defer committed UI presentation until durable turn/end. Reasoning/text still stream normally. Completed, interrupted and failed turns reveal successfully generated UI; partial/failed tools do not produce a flashing canvas.
+- Identify missing/invalid/duplicate node IDs separately with exact nested locations and first duplicate provenance. Mixed canvas/controls accept arbitrary JSON field order. Omitted canvas title/fallback inherit document values; guidance clarifies that state declarations do not create controls.
+- Use durable turn completion rather than live tail anchor values for presentation. Regression checks cover pending tool/result stages, late markers, single presentation, saved input and iframe identity after display.
+- Normalize plain numeric/boolean transport strings only in declared typed fields, and exact item-array wrappers across controls, nested containers, formulas, tables and action scopes. Preserve ordinary text, data and canvas source.
+- Decode a single state-specification JSON object or exact singular object wrapper, with unsafe-key/depth checks reapplied.
+- Name missing numeric fields, invalid ranges, options and formula argument paths in repair guidance. Inject a complete numeric-state example and recommend formula shorthand instead of deep argument trees or probe UIs.
+- Clarify round semantics, shared-state controls and direct UI-tool usage in injected guidance; use ui_catalog for protocol questions instead of searching DSH installation sources.
+
+## 0.5.5 — 2026-10-10
+
+- Describe all registered component fields in the native tool schema, including the nested steps item shape, and inject a minimal static process example.
+- Accept the exact lossless `items: {item: [...]}` adapter wrapper before native tool checks; static steps no longer require a task status. Normalize literal boolean strings on details.open.
+- Identify invalid steps by node, item index, actual type/count and correction example. Render tool failures as compact readable messages instead of full UI cards, preserving the actual error.
+
 ## 0.5.4 — 2026-10-10
 
 - Publish a native object schema for render_ui, including the document skeleton and component vocabulary. Legacy JSON strings are decoded internally; models are no longer offered a string branch that encourages double escaping.

package/README.md

@@ -6,6 +6,10 @@ Interactive, declarative tool views for **DeepSeek Harness Web 0.2.0-rc.2**.
 
 The plugin adds `ui_catalog` (protocol + examples + visual vocabulary) and `render_ui` (validated UI). It renders native conversation turn-tail views, computes local expressions, saves per-conversation input state on the Host, and sends explicit follow-up requests with the current parameter snapshot.
 
+### Reliable process guides (0.5.5)
+
+Static steps accept a direct items array without invented task statuses. The native tool schema now describes every registered component field and the nested step item structure. Exact lossless `items: {item: [...]}` adapter wrappers and literal boolean strings on details.open are normalized before native checks; ambiguous or unsafe inputs remain errors. Invalid steps report the node, index and correction. Failed tool calls retain their error in a compact message.
+
 ### Easier authoring and cleaner visuals (0.5.4)
 
 The tool schema exposes the document structure and accepts common authoring forms: inline table/chart rows, Chinese identifiers, text metrics, table captions and structured canvas state (`type:"json"`, array/object, max16KiB per value). Runtime arithmetic and chart series still require numbers; unknown fields and unsafe properties remain errors. Prefer passing a document object directly and use `render_canvas` for HTML/SVG source.
@@ -67,7 +71,7 @@ Development installs of `dsh-generative-ui` must be uninstalled before installin
 
 Free canvases now include optional theme-aware `.ui-*` primitives for typography, controls, result readouts, SVG nodes, connectors and annotations. Guided mode actively injects a construction handbook covering Chinese label widths, connector routing, actual rendered SVG font sizes, validated calculations and reset behavior. Free mode retains autonomous composition and only receives the interface/delivery contract.
 
-For `render_canvas`, emit `css` (an empty string if unused) before `html`, followed by `script`. Complete CSS plus partial HTML can produce a static streaming preview in a stable isolated frame. The preview strips active markup, disables controls and animation, has no state bridge, and never executes generated JavaScript. Interaction still starts only after successful submission and parameter restoration. Native `render_ui` continues to preview complete validated subtrees. Incomplete or failed generation does not become a saved interactive document.
+UI appears after the entire assistant turn ends, rather than during tool-argument streaming. While the model continues reasoning or writing, the tool shows a compact status without a preview canvas. This prevents a temporary preview flashing and disappearing before the final conversation UI is available. Successfully saved UI is also revealed when a turn is interrupted or ends with an error; incomplete or failed tools never become interactive documents. Controls activate after parameter restoration. Text and reasoning continue streaming normally.
 
 Each committed canvas offers **说明与操作 → 导出独立 HTML**. The downloaded file includes the current parameter snapshot, the shared calculation interpreter and an isolated canvas. Declared state and derived results recompute locally without DSH or external libraries. It is a single-canvas export, not a complete mixed native layout; it does not send Agent requests or save back to DSH. Reloading the file restores the export-time parameters. External resources remain unavailable.
 

package/VERIFICATION.md

@@ -1,5 +1,20 @@
 # Verification
 
+## 0.5.6 — authoring compatibility and stable presentation (2026-10-10)
+
+68 automated tests and 14 release stages cover typed transport normalization, decoded-object safety, exact node/argument diagnostics, field-order independence, canvas metadata defaults, durable end-of-turn UI presentation, state recovery, isolation and standalone export. Clean npm ci reports zero vulnerabilities. Production UI preview is disabled; static preview utilities remain internally tested but are not registered tool entry points.
+
+The end-of-turn browser regression uses the real turn extension plus production ToolView/TurnUiView: partial arguments, successful tool results, late prose markers and changing tail anchors do not mount UI/iframe before turn/end. After turn completion, a single UI appears and retains input and iframe identity. Interrupted/error endings also reveal successful results. Text/reasoning streaming and model stopping behavior are unchanged. Replaying the supplied real session events confirms readiness changes only on turn/end.
+
+Original travel-call replay passes eight of ten previously failing calls unchanged; two still need actual missing bounds/formula operands. Another session's three alleged field-order failures each omit sandbox id; adding only that id fixes them without reordering. No general model first-attempt success rate is claimed. Desktop local fixes were package-file verified and user-tested before this release; this does not change the declared Web compatibility range.
+
+## 0.5.5 — process guide authoring repair (2026-10-10)
+
+61 automated tests and 14 release checks cover the static steps contract, canonicalization before native tool validation, precise error paths and compact failure presentation. Replaying all five original render_ui argument sets from the reported exported session through the registered Host tool succeeds in an isolated temporary DSH_HOME: the first four retain five steps instead of falling back to text. No new model success-rate claim is made. Evidence: test-output/exported-steps-replay.json and test-output/release-verification.json.
+
+PC browser checks at 1920/1365px in light/dark themes verify five ordered steps without invented status labels, compact complete error text, no overflow and no document/state recovery warnings. Evidence: test-output/steps-verification.json and test-output/steps-repair-desktop.png. The original host/iframe timing checks now wait for propagated state; offline-export request counts isolate the exported page from host background diagnostics.
+
+
 ## 0.5.4 — main Web release acceptance (2026-10-10)
 
 Build `0.5.4+92e88973eabc` passes all 59 automated tests and 13 release checks after a clean `npm ci --ignore-scripts` (zero reported vulnerabilities). The main Web profile installs the packed package with all 54 distributed files matching. Its composed configuration validates after migration from the old package name. Actual Home → Plugins settings, saved calculator parameters, reload and downloaded offline HTML pass. Evidence: `test-output/motion054-main-web-smoke.json` and `test-output/release-verification.json`.