Repository navigation
Releases
XuanLing 0.11.2
Changed
- Refresh the Rust dependency graph:
rmcp3.9,tokio1.54,uuid1.29,
schemars1.2.3,serde_json1.0.154 and the ICU/wasm stack; upgrade
cap-stdto 4.0.3 andbase64to 0.23.1. - Replace
fs4with the standard library file-lock API (File::lock/
try_lock), removing a dev dependency. - Replace rmcp's deprecated
ServerInfoalias withServerConfigin both MCP
servers. Tool names and descriptions are unchanged.
Fixed
- Regenerate the
tools/listschema snapshot. Required keys now match fields
that were already always serialized (not_modified,truncated,
before_sha256,selected, memory proposaltags/applicability/pinned,
systemcwd). No tool output or runtime behavior changed.
Compatibility and limits
- No product behavior change; this is a dependency-maintenance release.
- MCP tool names, descriptions and wire payloads are unchanged. The regenerated
schema only adds required keys for fields that were already present. - Definition schema remains v2 and the conversation canvas is unchanged.
- The release publishes the nine npm items, DSH bundles and Blueprint plugin
from one verified commit.
XuanLing 0.11.1
Changed
- Rebuild the conversation Blueprint view around a read-only runtime canvas: compact node
readouts with kind rails and state chips, a single-line run ribbon with a DSH-native
28 px selector, a版本revision chip, a status-filtered legend and a populated minimap. - Multi-attempt nodes open an explicit popover picker; the separate attempts column is gone.
Frozen runs keep the archify seven-color kind palette, traversed edges and the optional
TeamStage card. - Align the conversation accent with the host interactive blue
(--dsw-alias-state-business-primary) and the run picker with DSH's model/workspace picker
grammar: 28 px, transparent, content width, hover-only fill, state dot. - Add
requiredCapabilities(repository-read/command-exec) for Agent tasks. Preflight
blocks admission when a node declares a capability but resolves no business tool, and marks
bound coverage as unverified. The Inspector shows declared capabilities; clipboard and
advanced JSON preserve them.
Added
- Attempt diagnostics carry an
outputdigest (type, bytes, SHA-256) derived from the
authoritative outcome; the diagnostics panel shows it without storing raw output. - Run reports expose per-step
acceptancebeside the scheduler state in the wire codec,
Markdown table and report UI, so a scheduled step is not mistaken for a delivered one. - Add
examples/repository-implementation, a strict implementation-report schema that rejects
placeholders, missing receipts or unknown fields, plus delivery-gate guidance.
Fixed
- Render a populated minimap for read-only runs by replaying measured content dimensions
without pinning node wrappers, which previously stalled the automatic Fit. - Keep exactly one live status node per seat state, including unbound sessions, and restore
the selected/run accent to the host's interactive blue.
Compatibility and limits
- Definition schema remains v2;
requiredCapabilitiesis optional and additive. Existing
definitions remain valid and require no migration. - New diagnostics and report fields are optional; legacy records read without migration.
- Model availability is still not validated before execution:
model-route-declaredremains
an info check until the Host exposes an authoritative model catalog. - The strict report schema constrains structure, not business truth. Branching on a report
field still needs a human decision node or a future boolean-extraction graph primitive. - The release publishes the nine npm items, DSH bundles and Blueprint plugin from one verified
commit. - Release
0.11.1supersedes an incomplete0.11.0publish attempt: only the
xuanling-mcp-darwin-arm64platform alias reached the registry, and no launcher, DSH
bundle or Blueprint package was published at0.11.0. The0.11.0tag remains as
release-audit evidence but is not a user-facing release.
XuanLing 0.10.1
Blueprint gains a dedicated desktop drag area and a clearer toolbar: library and workspace selection, editing controls, and Run actions have distinct groups. Secondary details move out of the top row, and Stop appears only when the editor has an associated Run.
This release also introduces the experimental @xuanling-rs/harness-bridge npm distribution, with native packages for macOS Apple Silicon, Linux x64 (glibc 2.35+) and Windows x64. A clean npm install resolves the matching executable without a local Rust build.
npx @xuanling-rs/harness-bridge@0.10.1 --config /absolute/path/to/bridge-config.jsonThe bridge exposes harness_health, harness_submit, harness_wait and harness_cancel, returning the worker's final answer and terminal facts. Codex workers use --ephemeral; Claude workers use --no-session-persistence. DSH and ZCode worker execution currently returns NATIVE_SESSION_PERSISTENCE_UNSUPPORTED; DSH can still act as a controller. The separate DSH adapter is available in the source checkout as a private integration package.
Blueprint definition schema remains v2 and requires no data migration. Bridge publication establishes the distribution boundary; it does not imply completion of deferred live worker/provider/controller acceptance. Native binaries have no Developer ID or Authenticode signature. Initial Bridge npm publication uses browser-authenticated CLI publishing; future provenance publishing requires Trusted Publisher configuration on all four Bridge packages.
XuanLing 0.10.0
XuanLing 0.10.0 keeps the macOS desktop window chrome above the Blueprint panel, refines the Blueprint panel chrome, and adds the source of the result-only harness bridge.
Added
- Keep the macOS desktop client's window chrome strip above the Blueprint toolbar and make that toolbar row a window-drag surface: dragging a blank run moves the DSH window while every control stays clickable. A plain browser tab keeps the compact toolbar without the extra strip.
- Refine the Blueprint panel chrome: one-row library cascade, status chips with semantic state beads, concentric toolbar capsules, inspector disclosure and dialog grammar, theme-correct React Flow controls, minimap and attribution, and readable placeholders in light and dark themes.
- Add the result-only harness bridge source and its CI gates: a stdio MCP host surface that submits work to a worker harness and returns only its final result and terminal status.
Fixed
- Resolve Blueprint state colours through the published DSH alert and warning tokens, so failed, waiting and dirty states follow the active theme instead of hard-coded fallbacks.
- Verify process-group ownership before a long-lived child joins a containment unit, and expose that check for hosts that manage the child themselves.
Compatibility and limits
- The harness bridge is source-only in this release. Its npm packages stay unpublished until the plan's live worker, host and native-platform gates close; its release boundary remains "not published".
- Definition schema remains v2 and this release requires no data migration. Blueprint desktop dragging needs a DSH macOS client that publishes
--dsh-frame-top-clearance; browser documents keep the previous layout. - Real provider, live worker and Windows/Linux native acceptance for the bridge remain deferred.
Install: npm install --global @xuanling-rs/xuanling-mcp@0.10.0. The four DeepSeek Harness bundles and the optional Blueprint plugin are published from the same commit; see the README for profile commands.
XuanLing 0.9.0
XuanLing 0.9.0 adds global/workspace Blueprint libraries, editable conversation plans, parameterized template sharing and workspace write coordination.
Added
- Browse profile-global and registered workspace Blueprint libraries from a
cascading selector. Discovery checks each workspace's.xuanlingdirectory
without creating it. Global definitions can be edited and saved without an
execution target; running requires a selected workspace. - Create, reference and edit Blueprint plans inside a conversation before a Run
exists. Saved plans retain their asset identity and revision, and Run progress
is reconciled from durable records after refresh or restart. - Share the current workflow ZIP or extract a parameterized template containing
its package files. Template preparation records bounded project evidence and
required inputs; startup rejects stale, missing or invalid preparation facts. - Coordinate business-tool writes by the real project root across Runs,
processes and custom runtime directories. Durable write intents, pre-tool
conflict checks and explicit recovery protect unresolved workspace effects.
Fixed
- Resolve Agent and Skill catalogs in the caller's DSH scope, including globally
installed filesystem skills. Selecting the global library clears project
context and isolates library storage by profile. - Preserve library and workspace selection through Run inspection, cancellation,
decisions, archive/restore and recovery. Correct native RPC argument handling
and actual panel routing for library selection and refresh. - Preserve template file bytes and digests, enforce storage containment and
writer locking, and make retries compare the complete package contents.
Compatibility and limits
- Definition schema remains v2. New Run records use schema 3; valid older
records remain readable and upgrade on write. Downgrading a runtime over new
records is not supported; retain a pre-upgrade data backup for rollback. - Workspace write coordination is advisory. Business tools are conservatively
serialized; arbitrary external writers and per-tool checks inside TeamStage
are outside the current guarantee. - Template adaptation provides explicit parameters and bounded file evidence.
Automatic semantic generalization and role/Agent/Skill/model matching remain
incomplete. Large-library pagination and the complete native desktop journey
also remain outside this release's verified scope. - Real provider acceptance, including the DeepSeek connectivity retest, remains
deferred. Deterministic, package and browser checks do not establish provider
acceptance or completion of the broader Blueprint implementation plan.
Install
dsh plugin --profile web add @xuanling-rs/xuanling-dsh-blueprint@0.9.0Restart the selected profile and refresh DSH. The runtime peer floor remains
>=0.2.1-alpha.5; the development fixture is 0.2.1-rc.2.
The synchronized MCP launcher is available with:
npm install --global @xuanling-rs/xuanling-mcp@0.9.0XuanLing 0.8.1
XuanLing 0.8.1 reissues the managed Blueprint workflow release after the interrupted 0.8.0 rollout. All packages use the new 0.8.1 version; application behavior and definition schema v2 match 0.8.0.
Added
- Managed Blueprint Agent nodes accept human clarification in their original
Attempt Session. Ordinary replies leave the node open;structured_output
explicitly completes it. New editor nodes and generation examples use managed
interaction; existing v2 nodes without the field retain one-shot behavior. blueprintCallinvokes a saved child at an exact revision with explicit input
and output ports. Parent Runs track child results, cancellation and recovery.
The editor includes child/revision selection, generated ports, preview,
interface diffs, explicit pin updates, and undo/redo. Frozen runtime views
provide child navigation, parent breadcrumbs and original node conversations.- Portable Blueprint exports include the complete pinned child closure. Imports
validate that closure before publishing the parent and preserve same-name
workflows in the destination library. The migration Skill documents manual
managed-node and composition upgrades, compatibility and rollback.
Fixed
- Conversation workflow changes and Run startup follow the calling DSH permission
preset: Full access skips human confirmation, Auto uses the native reviewer,
and ordinary review modes retain Host approval. An isolatedapproval=never
setting does not imply Full access. - Native authoring tools declare the definition parameter as an object and
distinguish it from serialized resource text, preventing ambiguous model
guidance that caused repeated validation of double-encoded definitions. - Blueprint child Sessions establish their one-shot identity before Agent
publication, preventing the native Team profile from installing an unrelated
Lead context and failing the node withTEAM_NOT_MEMBER.
Compatibility
- Definition schema remains v2. Older plugins reject the new
interactionand
blueprintCallfields; preserve a separate original copy before upgrading.
Runtime graphs remain frozen, graph-defined aggregation remains in place,
and model output budgets continue to follow DSH.
XuanLing 0.7.0
Breaking
- Blueprint definitions now use schema v2. Definitions saved by the published
0.6.1Blueprint package (schema v1, includingtoolCall,scriptCall,
subflowanditerationnodes) are rejected with
blueprint/definition-invalidand cannot be opened or run without migration.
All XuanLing packages share the0.7.0release version. There is no automatic
migration; use the migration Skill to prepare and validate a separate copy,
or keep0.6.1for the original workflows.
Added
- The
xuanling-blueprint-migrateSkill ships in the DSH skills bundle. It guides
schema v1-to-v2 and legacy profile-storage upgrades, preserves the original
package and Run history, validates resources and inputs, and records rollback
steps. Removed execution semantics require an explicit redesign rather than
only changing the schema version. workflow_reportreturns an execution report instead of the raw snapshot:
what ran (state, duration, model route per step), which step failed, why, and
what to change next time. It carries stable codes, fixed guidance and the
bounded operator recovery note; raw evidence, outputs and provider text are
never included.resolveRecoverylets a person move arecovery_requiredRun tofailedor
succeededwith a required note, guarded byexpectedSeq. The note is the
audit record; the unknown effect is never replayed. The conversation
Blueprint view offers the same decision for Runs created in its workspace.
TeamStage recoveries are still rejected and need manual Team cleanup.- The Blueprint sidebar shows revision history with a structural diff and a
CAS-guarded restore (restoreDefinitionRevision), a Run report with
localized guidance, recovery actions, and per-node resource provenance with
the binding digests frozen by the latest Run. The structural diff also warns
when only packaged resource files differ, because restoring then reverts
those files too.
Changed
- DSH development and harness dependencies are aligned to
0.2.1-rc.2; the
public runtime peer floor is>=0.2.1-alpha.5, with prereleases included in
compatibility checks. - Blueprint output token limits follow the selected model's DSH/Provider
configuration. Blueprint adds no separate model output budget. - Conversation tools and conversation Blueprint views follow the calling
session's registered DSH workspace instead of always using the Host default.
This includes Run history pagination, archive/restore and recovery for
conversation-created Runs; calls the Host cannot attribute fall back to the
Host default workspace. The sidebar editor still uses the Host default; an
explicitworkspaceRootstill pins every call.
Fixed
- Standalone Runs without a source conversation explain why node chat history
is unavailable and disable the chat button before interaction. Node outputs
and Run reports remain available; conversation-created Runs retain native
chat navigation.
XuanLing 0.6.1
Changed
- Blueprint node and group layout now measures rendered geometry before collision,
fit and visibility decisions, with stable group headers and runtime canvas sizing. - Node inspectors expose bindings by capability, port visibility switches guard new
connections while protecting existing edges, and resources are grouped with safe
Agent/Skill/MCP details and editable advanced JSON. - Blueprint source and tests are managed with Vite+ Oxfmt/Oxlint; the release keeps
the DSH0.2.1-alpha.3dependency tuple and the validated pnpm lockfile.
Fixed
- Post-format review removed stale geometry/oracle assumptions and dead compatibility
helpers without changing the runtime execution or resource safety contracts. - Invalid advanced resource JSON remains editable without crashing the resource
dialog; release verification accepts the exact formatting script contract.
This release targets DSH 0.2.1-alpha.3. TeamStage remains optional and requires the native Team profile.
XuanLing 0.6.0
0.6.0 - 2026-10-14
Added
- Blueprint libraries can create durable definitions from an empty library.
New drafts receive Host-assigned IDs on first save, with idempotent creation
and revision checks. Native Agents can useblueprint_describe,
blueprint_validate,blueprint_createandblueprint_preflightto prepare
complete definitions and declared resource files before explicit execution. - Agent, Skill and MCP selectors show current DSH resources first, followed by
blueprint resources. Host Agent presets retain structured composition, Skills
capture their complete directories, and MCP bindings retain exact tool identities. - Ordinary Agent tasks can select a provider, model and optional reasoning effort
in the Inspector. Explicit selection overrides the DSH default; each Attempt
freezes the final route and resources before dispatch and records safe diagnostics. - Custom Host resources travel in portable ZIPs: Agent presets and MCP definitions
use typed artifacts, and Skills include their supporting files. Only verified
official DSH builtins omit resource bodies. Credentials and machine-specific
values become destination binding requirements; import validates artifacts
without activating plugins or connecting MCP servers, and re-export preserves
those requirements.
Changed
- Canvas editing adds drag-to-create nodes, collapsible library/Inspector panes,
proportional corner resizing and clearer resource labels. Inspector port rows
and resource/model controls support the save, check, run and inspect workflow. - Advanced node JSON, resource JSON and Run inputs use a JSON editor with syntax
highlighting, error locations, indentation, formatting and independent undo/redo.
Formatting does not save or run. Blueprint deletion requires confirmation and
preserves existing Run history without cancelling active Runs. - Source input/output ports are checked during preflight; generated downstream
values remain subject to runtime type validation. Unsupported TeamStage Agent
preset resources are rejected before execution. - The bilingual Blueprint README now starts with installation and practical
canvas/native-Agent steps, including resource selection, model routing, results
and complete ZIP migration. Legacy downgrade export is no longer offered. - Cargo, the npm launcher/native aliases, all five DSH packages and both ZCode
plugin manifests use the same0.6.0release version.
Fixed
- Ordinary conversations without a linked blueprint show a neutral empty view.
Switching views does not turn that empty state into a stale failure; switching
sessions does not display the previous session's error. Real read/offline
failures remain distinct, retain confirmed bound snapshots and support refresh. - Portable Host artifacts reject credential-bearing URL variants and API key
aliases while preserving ordinary non-secret configuration. Imported artifacts
retain complete binding requirements when exported again. - JSON editor keyboard bindings support indentation, undo/redo and focus escape
without losing ordinary typing or IME input. - Blueprint ping and typed capability errors report the release version, with
the release version check also guarding the runtime constant against drift.
Runtime and Upgrade Notes
- Native
blueprint_preflightandblueprint_startacceptinputas a JSON value.
Model-facing callers using the formerinputJsonstring argument must migrate;
browser RPC continues to use JSON text. Creation and inspection do not start Runs. - DSH support still follows the latest official capability channel. TeamStage
remains optional, requires an explicitly enabled native Team profile and source
Lead, and retains its separate member/model contract. Ordinary Agent acceptance
does not establish TeamStage or other-platform/provider acceptance. - The generic MCP contract remains
3, the persisted Memory contract remains2,
and this release does not add a Memory database migration. Existing RunRecord
legacy reads and backup/restore remain supported; unknown external effects
require reviewed recovery rather than automatic replay.
XuanLing MCP v0.5.2
XuanLing MCP v0.5.2
This release publishes the XuanLing MCP launcher, locked native platform variants, four DeepSeek Harness bundles, and the optional Blueprint/TeamStage plugin from source commit ffcef9107e36c131292b1c2b20f12e3e7bd2480e.
The Blueprint package is now managed and verified through the repository's pnpm flow:
pnpm add --save-exact @xuanling-rs/xuanling-dsh-blueprint@0.5.2Published npm items:
@xuanling-rs/xuanling-mcp@0.5.2@xuanling-rs/xuanling-mcp-darwin-arm64@0.5.2-darwin-arm64@xuanling-rs/xuanling-mcp-linux-x64-gnu@0.5.2-linux-x64-gnu@xuanling-rs/xuanling-mcp-win32-x64-msvc@0.5.2-win32-x64-msvc@xuanling-rs/xuanling-dsh-memory@0.5.2@xuanling-rs/xuanling-dsh-skills@0.5.2@xuanling-rs/xuanling-dsh-tools@0.5.2@xuanling-rs/xuanling-dsh-tools-replace@0.5.2@xuanling-rs/xuanling-dsh-blueprint@0.5.2
The verified ZCode marketplace projection was promoted to umbrella22/xuanling-zcode-marketplace at the matching xuanling-mcp-v0.5.2 tag.
Release validation completed in GitHub Actions run 38290864039, including pnpm Blueprint install/build/test, exact artifact verification, npm registry integrity reconciliation for all nine items, and ZCode promotion.