dsh-plugin-auto-install

Usage

Option 1: dynamic plugin (current session, recommended)

In a DSH session, ask the agent to:

1. cordis_define (kind: new, idPrefix: dshi) — put the module.exports object from plugin/host.js into code.host (or paste the apply body directly);
2. cordis_run (mode: run) to activate;
3. The dsh_plugin_install tool then appears in the tool list and is called automatically whenever an install is needed.

Option 2: permanent mount (survives restarts)

Mount plugin/host.js as a row in an agent preset's agent.cordis.yml (e.g. a copy of standard), or add it to the host composition. It depends on the host services shell, sandboxPolicy, approval, and tools.

Tool parameters: dsh_plugin_install

Parameter	Required	Description
package	✔	npm package name, e.g. @liustack/modlens
version		explicit version; defaults to the latest resolved at install time
profile		DSH profile, default web
profileRoot		DSH home directory holding the profiles, default C:\Users\jiang\.dsh (used for post-install verification)
nodePath		override node.exe path (default D:\ruanjian\NodeJs\node.exe)
dshBin		override DSH CLI bin.js path
dryRun		true resolves the version and reports what would be installed, without making any changes
sandbox_permissions		pre-request sandbox escalation (workspace-write / danger-full-access); requires justification

Returns: { ok, package, version, message, installExitCode, outputTail, sandboxMode, sandboxDenied, verified, restartRequired }.

Example:

dsh_plugin_install(package: "@liustack/modlens")
→ ok: true, version: 3.17.0, verified: true, sandboxMode: danger-full-access
  "installed @liustack/modlens@3.17.0 into profile web (direct) and verified
   (dependencies: yes; dsh.profile.bundles: yes). Restart DSH..."

---