dsh-gitbash-shell 0.12.0 → 0.13.0

package/assets/minimal-gitbash/agent.cordis.ps.yml

@@ -7,13 +7,13 @@
 # change across the 0.1.1 → 0.1.2 code→ptc rename, so no agent.cordis.ptc.yml
 # twin exists here. The plugin probes the roster and writes this file as the
 # preset's own agent.cordis.yml either way.
-# The `minimal` agent preset: a fixed-prompt, two-tool coding-agent composition.
+# The `minimal` agent preset: a fixed-prompt, single-tool coding-agent composition.
 #
 # The persona is the complete system prompt, so global identity, Web orientation,
 # tool guidance, and later assembly listeners cannot add prompt text. Runtime
-# context snapshots are suppressed for this preset, and the model composes only
-# the persistent shell (Git for Windows bash; bash on POSIX) and
-# `str_replace_editor`. Context compaction is absent.
+# context snapshots are suppressed for this preset, and the model receives only
+# the persistent shell (Git for Windows bash; bash on POSIX). Context compaction
+# is absent.
 
 - id: persona
   name: '@deepseek-ai/dsh-persona'
@@ -51,8 +51,7 @@
         description: |-
           Run commands in a bash shell (Git for Windows bash on Windows: native paths like C:/... work, and PATH plus the rest of the environment are inherited from the host)
           * When invoking this tool, the contents of the "command" parameter does NOT need to be XML-escaped.
-          * You don't have access to the internet via this tool.
-          * You do have access to a mirror of common linux and python packages via apt and pip.
+          * Network access depends on the task environment. Prefer configured mirrors/proxies when they are available.
           * State is persistent across command calls and discussions with the user.
           * To inspect a particular line range of a file, e.g. lines 10-25, try 'sed -n 10,25p /path/to/the/file'.
           * Please avoid commands that may produce a very large amount of output.
@@ -78,21 +77,3 @@
           * Use native Windows paths (C:\...) and $env:NAME variables; this is PowerShell, not bash.
           * Please avoid commands that may produce a very large amount of output.
           * Please run long lived commands in the background, e.g. 'Start-Job' or start a server with Start-Process.
-
-# The bare local filesystem shadows the host's sandboxed provider only for this
-# preset. The editor shares that realm and requires absolute paths.
-- id: filesystem
-  name: cordis:group
-  group: true
-  isolate:
-    fs: true
-  config:
-    - id: fs-local
-      name: '@deepseek-ai/dsh-fs-local'
-      config:
-        cwd: !!js process.env.DSH_CWD ?? process.cwd()
-
-    - id: str-replace-editor
-      name: '@deepseek-ai/dsh-tool-str-replace-editor'
-      config:
-        maxOutputChars: 16000

package/assets/minimal-gitbash/agent.cordis.yml

@@ -2,13 +2,13 @@
 # change across the 0.1.1 → 0.1.2 code→ptc rename, so no agent.cordis.ptc.yml
 # twin exists here. The plugin probes the roster and writes this file as the
 # preset's own agent.cordis.yml either way.
-# The `minimal` agent preset: a fixed-prompt, two-tool coding-agent composition.
+# The `minimal` agent preset: a fixed-prompt, single-tool coding-agent composition.
 #
 # The persona is the complete system prompt, so global identity, Web orientation,
 # tool guidance, and later assembly listeners cannot add prompt text. Runtime
-# context snapshots are suppressed for this preset, and the model composes only
-# the persistent shell (Git for Windows bash; bash on POSIX) and
-# `str_replace_editor`. Context compaction is absent.
+# context snapshots are suppressed for this preset, and the model receives only
+# the persistent shell (Git for Windows bash; bash on POSIX). Context compaction
+# is absent.
 
 - id: persona
   name: '@deepseek-ai/dsh-persona'
@@ -46,8 +46,7 @@
         description: |-
           Run commands in a bash shell (Git for Windows bash on Windows: native paths like C:/... work, and PATH plus the rest of the environment are inherited from the host)
           * When invoking this tool, the contents of the "command" parameter does NOT need to be XML-escaped.
-          * You don't have access to the internet via this tool.
-          * You do have access to a mirror of common linux and python packages via apt and pip.
+          * Network access depends on the task environment. Prefer configured mirrors/proxies when they are available.
           * State is persistent across command calls and discussions with the user.
           * To inspect a particular line range of a file, e.g. lines 10-25, try 'sed -n 10,25p /path/to/the/file'.
           * Please avoid commands that may produce a very large amount of output.
@@ -73,21 +72,3 @@
           * Use native Windows paths (C:\...) and $env:NAME variables; this is PowerShell, not bash.
           * Please avoid commands that may produce a very large amount of output.
           * Please run long lived commands in the background, e.g. 'Start-Job' or start a server with Start-Process.
-
-# The bare local filesystem shadows the host's sandboxed provider only for this
-# preset. The editor shares that realm and requires absolute paths.
-- id: filesystem
-  name: cordis:group
-  group: true
-  isolate:
-    fs: true
-  config:
-    - id: fs-local
-      name: '@deepseek-ai/dsh-fs-local'
-      config:
-        cwd: !!js process.env.DSH_CWD ?? process.cwd()
-
-    - id: str-replace-editor
-      name: '@deepseek-ai/dsh-tool-str-replace-editor'
-      config:
-        maxOutputChars: 16000

package/assets/minimal-gitbash/preset.yml

@@ -1,3 +1,3 @@
 name: 极简模式 · Git Bash
-description: 仅提供持久 bash 与 str_replace_editor 的双工具编码 Agent。（Shell 使用 Git Bash）
+description: 仅提供持久 shell 的单工具编码 Agent。（Shell 使用 Git Bash）
 order: 3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-gitbash-shell",
-  "version": "0.12.0",
+  "version": "0.13.0",
   "description": "DSH plugin: run every agent shell command through Git for Windows bash on Windows instead of PowerShell. Replaces the pwsh executor with a Git Bash ctx.shell provider and materializes Git Bash variants of the standard/minimal/code/cordis agent presets into your user preset root at startup. On Windows it also adopts dsh-better-sidebar's terminal shell (UI tabs and the model-facing terminal_* tools) through the sidebar's official settings seam, and pairs with dsh-ptc-cordis-preset so the PTC Creation-mode preset materializes as its Git Bash variant. Ships both composition eras for dsh <= 0.1.1 (built-in preset id 'code') and dsh >= 0.1.2 (renamed id 'ptc') — the era is probed per boot and re-materialized automatically after a dsh upgrade, in either upgrade order; preset ids never change so pinned sessions stay valid.",
   "type": "module",
   "repository": {

package/src/index.js

@@ -224,11 +224,18 @@ function pickComposition(base, persona, available) {
 }
 
 /** Startup decision for an existing unmodified tree: 'refresh' or 'idle'. */
-function syncDecision({ state, marker, version, sourceHashes, base = 'code', persona = 'text' }) {
+function syncDecision({ state, marker, version, sourceHashes, base = 'code', persona = 'text', present = false }) {
   if (state !== 'unmodified' || !marker) return 'refresh'
   if (marker.version !== version) return 'refresh'
   if (marker.base !== base) return 'refresh'
   if ((marker.persona ?? 'text') !== persona) return 'refresh'
+  // Host-capability flip: @deepseek-ai/dsh-tool-present first shipped with dsh
+  // 0.1.5-alpha.2. A preset composed with the row on a host that lacks the
+  // package REJECTS THE WHOLE MOUNT (mount.ts: a row whose module failed to
+  // import already rejects the mount), so the row is injected only when the
+  // host resolves it — and a host upgrade past that point must re-materialize
+  // to gain it (same marker-dimension pattern as persona).
+  if ((marker.present ?? false) !== present) return 'refresh'
   const recorded = {}
   for (const k of Object.keys(marker.files)) if (k.startsWith('skills/')) recorded[k] = marker.files[k]
   if (sourceHashes === null) return Object.keys(recorded).length === 0 ? 'idle' : 'refresh'
@@ -241,14 +248,56 @@ function syncDecision({ state, marker, version, sourceHashes, base = 'code', per
 
 // ── materialization ─────────────────────────────────────────────────────────
 
+/*
+ * Conditional present-row injection (v0.13.0, dsh 0.1.5-alpha.2 sync). The
+ * official ptc/standard/cordis compositions appended `- id: present / name:
+ * '@deepseek-ai/dsh-tool-present'` (immutable file-delivery download cards).
+ * The row is NOT committed into the ptc-era twin files: a host older than
+ * 0.1.5-alpha.2 lacks the package, and a composition row that fails to
+ * import rejects the WHOLE preset mount. Instead the materializer probes the
+ * host (hostHasToolPresent) and splices the row in as PLAIN TEXT — anchor
+ * string surgery only, never a YAML round-trip, so !!js literals survive.
+ * Placement mirrors the official compositions: right after the
+ * tool-presentation block when the composition has one (all ptc-derived
+ * twins), otherwise appended at the tail (cordis/standard twins). Only
+ * `.ptc.` files are ever touched: code-era (<= 0.1.1) snapshots and the
+ * minimal variants are frozen history (official minimal never gained the
+ * row — it is the single-tool preset).
+ */
+const PRESENT_ROW = "\n- id: present\n  name: '@deepseek-ai/dsh-tool-present'\n"
+const PRESENT_ANCHOR = "  name: '@deepseek-ai/dsh-agent-tool-presentation'\n  config:\n    mode: ptc\n"
+
+function injectPresentRow(text) {
+  if (text.includes("'@deepseek-ai/dsh-tool-present'")) return text
+  const at = text.indexOf(PRESENT_ANCHOR)
+  if (at !== -1) return text.slice(0, at + PRESENT_ANCHOR.length) + PRESENT_ROW + text.slice(at + PRESENT_ANCHOR.length)
+  return text.endsWith('\n') ? text + PRESENT_ROW : text + '\n' + PRESENT_ROW
+}
+
+let toolPresentCache
+/** Probe whether THIS host can resolve the present package (cached per boot). */
+async function hostHasToolPresent() {
+  if (toolPresentCache !== undefined) return toolPresentCache
+  try {
+    const { createRequire } = await import('node:module')
+    createRequire(import.meta.url).resolve('@deepseek-ai/dsh-tool-present')
+    toolPresentCache = true
+  } catch {
+    toolPresentCache = false
+  }
+  return toolPresentCache
+}
+
 /** Write one preset directory from scratch. Returns 'ok' or 'no-skills-source'. */
-function materialize({ target, presetId, skillsSource, version, base = 'code', persona = 'text' }) {
+function materialize({ target, presetId, skillsSource, version, base = 'code', persona = 'text', present = false }) {
   rmSync(target, { recursive: true, force: true })
   mkdirSync(target, { recursive: true })
 
   const available = readdirSync(join(pkgDir, 'assets', presetId)).filter((f) => f.endsWith('.yml'))
   const compositionFile = pickComposition(base, persona, available)
-  writeFileSync(join(target, 'agent.cordis.yml'), readFileSync(join(pkgDir, 'assets', presetId, compositionFile)))
+  let composition = readFileSync(join(pkgDir, 'assets', presetId, compositionFile), 'utf8')
+  if (present && compositionFile.includes('.ptc.')) composition = injectPresentRow(composition)
+  writeFileSync(join(target, 'agent.cordis.yml'), composition)
   writeFileSync(join(target, 'preset.yml'), readFileSync(join(pkgDir, 'assets', presetId, 'preset.yml')))
 
   let skills = 'none'
@@ -262,7 +311,7 @@ function materialize({ target, presetId, skillsSource, version, base = 'code', p
     }
   }
 
-  const marker = { managedBy: MANAGED_BY, version, presetId, base, persona, files: hashTree(target) }
+  const marker = { managedBy: MANAGED_BY, version, presetId, base, persona, present, files: hashTree(target) }
   writeFileSync(join(target, MARKER_FILE), JSON.stringify(marker, null, 2) + '\n')
   return skills
 }
@@ -871,6 +920,7 @@ export async function apply(ctx, config = {}) {
   const skillsSource = await findSkillsSource(ctx.agentPresets)
   const base = await detectBase(ctx.agentPresets)
   const persona = await detectPersonaEra(ctx.agentPresets)
+  const present = await hostHasToolPresent()
   const userRootPath = userRoot.path
   purgeOrphans(userRootPath, presetIds)
 
@@ -900,12 +950,12 @@ export async function apply(ctx, config = {}) {
 
     const sourceHashes = presetId === 'cordis-gitbash' ? skillsHashes(skillsSource) : null
     const marker = readMarker(target)
-    if (state === 'unmodified' && syncDecision({ state, marker, version, sourceHashes, base, persona }) === 'idle') {
+    if (state === 'unmodified' && syncDecision({ state, marker, version, sourceHashes, base, persona, present }) === 'idle') {
       ctx.logger?.('gitbash-shell')?.debug?.( `preset '${presetId}' up to date (v${version}, ${base}-era${persona === 'split' ? ', persona-split' : ''}) — idle`)
       continue
     }
 
-    const skills = materialize({ target, presetId, skillsSource, version, base, persona })
+    const skills = materialize({ target, presetId, skillsSource, version, base, persona, present })
     const verb = state === 'absent' ? 'materialized' : 'refreshed'
     console.log(
       `${TAG} ${verb} preset '${presetId}' into ${userRootPath} (v${version}, ${base}-era composition${persona === 'split' ? ', persona-split' : ''})` +
@@ -915,4 +965,4 @@ export async function apply(ctx, config = {}) {
 }
 
 // Test surface: pure helpers, no Cordis context required.
-export const _internal = { PRESET_IDS, translateMsysPath, translatePathArguments, readPosixPaths, windowsToMsys, rewriteResultPaths, MARKER_FILE, classify, materialize, cleanupOnDispose, firstUserRoot, hashTree, skillsHashes, syncDecision, installRegisterShim, baseForRoster, detectBase, pickComposition, personaEraForText, detectPersonaEra }
+export const _internal = { PRESET_IDS, translateMsysPath, translatePathArguments, readPosixPaths, windowsToMsys, rewriteResultPaths, MARKER_FILE, classify, materialize, cleanupOnDispose, firstUserRoot, hashTree, skillsHashes, syncDecision, installRegisterShim, baseForRoster, detectBase, pickComposition, personaEraForText, detectPersonaEra, injectPresentRow, hostHasToolPresent }