dsh-ptc-plus 0.4.10 → 0.5.1

package/internal/worker-cwd-virtualization.js

@@ -7,7 +7,7 @@ import {
   installProjectedProcessCwd,
 } from './worker-realm-surfaces.js'
 
-const { Reflect: privateReflect, appendArray, bufferConcat, bufferIsBuffer, bufferToString,
+const { Reflect: privateReflect, appendArray, bufferConcat, bufferFrom, bufferIsBuffer, bufferToString,
   copyArray, isArray, regexpTest } = internal
 const TRAILING_SEPARATOR = /[\\/]$/
 
@@ -108,29 +108,32 @@ export function projectChildProcessArguments(name, args, sessionCwd) {
     : withDefaultOptions(2)
 }
 
-/** Install one session's cwd projection into Node builtins loaded by the worker. */
-export function installWorkerCwdVirtualization(sessionCwd, originalRequire, markVolatile) {
+/** Install stable Node wrappers; the execution owner supplies each cell's cwd. */
+export function installWorkerCwdVirtualization(sessionCwd, originalRequire, markVolatile, readCwd = () => sessionCwd) {
+  const nativeCwd = process.cwd
+  const currentCwd = () => readCwd() ?? privateReflect.apply(nativeCwd, process, [])
   if (sessionCwd === undefined) {
-    const nativeCwd = process.cwd
     assignWorkerRealmProperty(WORKER_REALM_MUTATION.STABLE, 'process.cwd', process, 'cwd', () => {
-      markVolatile('process.cwd')
-      return privateReflect.apply(nativeCwd, process, [])
+      if (readCwd() === undefined) markVolatile('process.cwd')
+      return currentCwd()
     })
-    return
-  }
+  } else installProjectedProcessCwd(process, currentCwd)
   const nativeResolve = resolve
-  const bufferPrefix = Buffer.from(sessionCwd + (regexpTest(TRAILING_SEPARATOR, sessionCwd) ? '' : sep))
+  const directoryPrefix = () => {
+    const cwd = currentCwd()
+    return cwd + (regexpTest(TRAILING_SEPARATOR, cwd) ? '' : sep)
+  }
   const sessionPath = (value) => {
-    if (typeof value === 'string') return isAbsolute(value) ? value : nativeResolve(sessionCwd, value)
+    if (typeof value === 'string') return isAbsolute(value) ? value : nativeResolve(currentCwd(), value)
     if (bufferIsBuffer(value)) {
       const absolute = isAbsolute(bufferToString(value, 'utf8', 0, 3))
-      return absolute ? value : bufferConcat([bufferPrefix, value])
+      return absolute ? value : bufferConcat([bufferFrom(directoryPrefix()), value])
     }
     return value
   }
   const sessionPathPrefix = (value) => {
     if (typeof value !== 'string' || isAbsolute(value) || parse(value).root !== '') return sessionPath(value)
-    return sessionCwd + (regexpTest(TRAILING_SEPARATOR, sessionCwd) ? '' : sep) + value
+    return directoryPrefix() + value
   }
   const projectPaths = (args, indices) => {
     const next = copyArray(args)
@@ -148,18 +151,17 @@ export function installWorkerCwdVirtualization(sessionCwd, originalRequire, mark
   const sessionGlobOptions = (args) => {
     if (typeof args[1] === 'function') {
       const next = copyArray(args, 0, 1)
-      appendArray(next, { cwd: sessionCwd })
+      appendArray(next, { cwd: currentCwd() })
       return copyArray(args, 1, args.length, next)
     }
     const next = copyArray(args)
-    if (next[1] === undefined) next[1] = { cwd: sessionCwd }
+    if (next[1] === undefined) next[1] = { cwd: currentCwd() }
     else if (next[1] !== null && typeof next[1] === 'object' && next[1].cwd === undefined) {
-      next[1] = { ...next[1], cwd: sessionCwd }
+      next[1] = { ...next[1], cwd: currentCwd() }
     }
     return next
   }
 
-  installProjectedProcessCwd(process, sessionCwd)
   const fs = originalRequire('node:fs')
   const path = originalRequire('node:path')
   for (const [name, indices] of Object.entries(FILE_SYSTEM_PATH_ARGUMENTS)) {
@@ -174,10 +176,10 @@ export function installWorkerCwdVirtualization(sessionCwd, originalRequire, mark
     wrapBuiltin(fs, name, sessionGlobOptions)
     wrapBuiltin(fs.promises, name, sessionGlobOptions)
   }
-  wrapBuiltin(path, 'resolve', args => copyArray(args, 0, args.length, [sessionCwd]))
+  wrapBuiltin(path, 'resolve', args => copyArray(args, 0, args.length, [currentCwd()]))
   const childProcess = originalRequire('node:child_process')
   for (const name of ['exec', 'execFile', 'execFileSync', 'execSync', 'fork', 'spawn', 'spawnSync']) {
     wrapBuiltin(childProcess, name,
-      args => projectChildProcessArguments(name, args, sessionCwd), CHILD_PROCESS_PROJECTED_PROPERTIES[name])
+      args => projectChildProcessArguments(name, args, currentCwd()), CHILD_PROCESS_PROJECTED_PROPERTIES[name])
   }
 }

package/internal/worker-realm-surfaces.js

@@ -41,7 +41,7 @@ export const WORKER_REALM_SURFACE_CONTRACT = objectFreeze([
     surface: 'process.cwd',
     owner: 'internal/worker-cwd-virtualization.js',
     classification: WORKER_REALM_MUTATION.STABLE,
-    contract: 'recorded cwd; immutable and non-configurable when a session cwd exists',
+    contract: 'current recorded cell cwd; callable immutable and non-configurable when a session cwd exists',
     reference: 'plain Node worker process descriptor',
     verification: 'cwd-descriptor',
   }),
@@ -49,7 +49,7 @@ export const WORKER_REALM_SURFACE_CONTRACT = objectFreeze([
     surface: 'cwd-projected Node builtins',
     owner: 'internal/worker-cwd-virtualization.js',
     classification: WORKER_REALM_MUTATION.STABLE,
-    contract: 'relative fs, path, and child-process calls use the recorded cwd while retaining callable descriptors',
+    contract: 'relative fs, path, and new child-process calls use the current recorded cell cwd while retaining callable descriptors',
     reference: 'plain Node worker fs, fs/promises, path, and child_process callable descriptors',
     verification: 'cwd-projected-builtins',
   }),
@@ -148,7 +148,7 @@ export function installProjectedProcessCwd(processObject, cwd) {
     configurable: false,
     enumerable: true,
     writable: false,
-    value: () => cwd,
+    value: typeof cwd === 'function' ? cwd : () => cwd,
   })
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-ptc-plus",
-  "version": "0.4.10",
+  "version": "0.5.1",
   "icon": "assets/ptc-plus-icon.svg",
   "description": "A session-bound agent-native REPL for DeepSeek Harness PTC mode.",
   "type": "module",
@@ -8,13 +8,13 @@
   "exports": {
     ".": "./index.js",
     "./execution-provider": "./internal/execution-provider-owner.js",
-    "./client": "./client.js",
+    "./client": "./client.cjs",
     "./package.json": "./package.json",
     "./locale/*.json": "./locale/*.json"
   },
   "files": [
     "index.js",
-    "client.js",
+    "client.cjs",
     "compiler-core.cjs",
     "compiler-core.cjs.map",
     "compiler-platform.cjs",
@@ -42,45 +42,32 @@
     "LICENSE"
   ],
   "engines": {
-    "node": "^22.19.0 || >=24.0.0"
+    "node": "^22.19.0 || >=24.0.0",
+    "dsh": "*"
   },
   "allowScripts": {
     "esbuild": false
   },
   "dependencies": {
     "@babel/code-frame": "^7.29.7",
-    "@babel/core": "^7.29.7",
-    "@babel/generator": "^7.29.8",
-    "@babel/helper-create-class-features-plugin": "^7.29.7",
     "@babel/parser": "^7.29.0",
-    "@babel/plugin-proposal-decorators": "^7.29.7",
-    "@babel/plugin-transform-explicit-resource-management": "^7.29.7",
-    "@babel/plugin-transform-optional-chaining": "^7.29.7",
-    "@babel/plugin-transform-typescript": "^7.29.7",
-    "@babel/traverse": "^7.29.0",
-    "@codemirror/lang-javascript": "^6.2.5",
-    "@codemirror/language": "^6.12.4",
-    "@codemirror/state": "^6.7.4",
-    "@codemirror/view": "^6.43.11",
-    "@deepseek-ai/schemastery": "^3.18.3",
     "@deepseek-ai/dsh-util-values": "^0.2.0-rc.2 || ^0.2.1-alpha.1",
+    "@deepseek-ai/schemastery": "^3.18.3",
     "@jridgewell/trace-mapping": "^0.3.31",
-    "@lezer/highlight": "^1.2.3",
-    "acorn": "^8.15.0",
-    "amaro": "1.1.11",
-    "codemirror": "^6.0.2",
-    "fflate": "^0.8.3",
-    "pathe": "^2.0.3",
-    "react-is": "^19.3.0",
-    "tslib": "^2.8.1",
-    "typescript": "^6.0.3"
+    "acorn": "^8.15.0"
   },
   "peerDependencies": {
+    "@deepseek-ai/cordis": "*",
     "@deepseek-ai/dsh-atomic-write": "*",
     "@deepseek-ai/dsh-home-paths": "*",
     "@deepseek-ai/dsh-llm": "*",
+    "@deepseek-ai/dsh-scope": "*",
+    "@deepseek-ai/dsh-session": "*",
+    "@deepseek-ai/dsh-session-format-catalog": "*",
     "@deepseek-ai/dsh-settings": "*",
+    "@deepseek-ai/dsh-skill": "*",
     "@deepseek-ai/dsh-skill-filesystem": "*",
+    "@deepseek-ai/dsh-spill-policy": "*",
     "@deepseek-ai/dsh-tool-cordis": "*",
     "@deepseek-ai/dsh-tools": "*",
     "@deepseek-ai/dsh-typert-protocol": "*"
@@ -89,12 +76,18 @@
     "build": "node scripts/client-bundle.mjs build && node scripts/compiler-bundle.mjs build",
     "build:check": "node scripts/client-bundle.mjs check && node scripts/compiler-bundle.mjs check",
     "test:client": "vitest run --config scripts/client-test.config.mjs",
+    "test:client:focus": "node scripts/client-focused-tests.mjs",
+    "test:client:fixtures": "vitest run --config scripts/client-test.config.mjs --testNamePattern=\"^(REPL observations and shared workbench remain separate from session execution|saved cards retain exact source across remount and locale changes; catalog conflicts keep drafts actionable)$\"",
     "test:client:visual": "node scripts/client-visual-check.mjs",
-    "test:semantics": "node --test --test-concurrency=1 test/semantic-test262.test.js test/semantic-dialect.test.js test/semantic-boundaries.test.js",
+    "test:semantics": "node scripts/test-suite-files.mjs --file test/semantic-test262.test.js --file test/semantic-dialect.test.js --file test/semantic-boundaries.test.js --file test/semantic-boundary-storage.test.js --file test/semantic-boundary-promises.test.js --file test/semantic-boundary-reflection.test.js",
     "semantic:check": "node scripts/semantic-obligations.mjs",
     "test:client:web": "node scripts/client-web-smoke.mjs",
+    "test:client:tool-hover:focus": "node scripts/client-tool-hover.mjs --focus",
+    "test:client:fallback:focus": "node scripts/client-fallback-smoke.mjs --focus",
+    "test:client:layout:focus": "node scripts/client-binding-layout.mjs --focus",
     "test:client:fallback": "node scripts/client-fallback-smoke.mjs",
     "test:client:layout": "node scripts/client-binding-layout.mjs",
+    "readme:screenshots": "node scripts/readme-screenshots.mjs",
     "host:baseline:update": "node scripts/dsh-dependency-baseline.mjs update",
     "host:baseline:verify": "node scripts/dsh-dependency-baseline.mjs verify",
     "test:host-contract": "node scripts/dsh-host-contract-suite.mjs",
@@ -112,12 +105,16 @@
     "session:migrate": "node scripts/migrate-session-log.mjs",
     "coverage": "node scripts/coverage.mjs",
     "coverage:focus": "node scripts/coverage.mjs --focus",
+    "test:backend:focus": "node scripts/test-suite-files.mjs --focus",
+    "test:backend": "node scripts/test-suite-files.mjs",
     "test:ci:runtime": "node --test --test-concurrency=1 test/package-contract.test.js test/compiler-platform.test.js test/direct-surface-policy.test.js test/isolated-entrance.test.js test/plugin-native-call-transport.test.js",
-    "verify": "npm run review:validate && npm run host:baseline:verify && npm run semantic:check && npm run build:check && node --check index.js && node --check internal/kernel-worker.js && node --check scripts/migrate-session-log.mjs && node --check scripts/expensive-headless-acceptance.mjs && node --check scripts/ab-headless-trajectories.mjs && npm run test:client:visual && npm run coverage",
-    "verify:ci": "npm run review:validate && npm run host:baseline:verify && npm run semantic:check && npm run build:check && node --check index.js && node --check internal/kernel-worker.js && node --check scripts/migrate-session-log.mjs && npm run test:client:visual && npm run test:ci:runtime",
+    "verify": "npm run review:validate && npm run host:baseline:verify && npm run semantic:check && npm run build:check && node --check index.js && node --check internal/kernel-worker.js && node --check scripts/migrate-session-log.mjs && node --check scripts/expensive-headless-acceptance.mjs && node --check scripts/ab-headless-trajectories.mjs && node scripts/deterministic-test-groups.mjs",
+    "verify:ci": "npm run review:validate && npm run host:baseline:verify && npm run semantic:check && npm run build:check && node --check index.js && node --check internal/kernel-worker.js && node --check scripts/migrate-session-log.mjs && node scripts/deterministic-test-groups.mjs --ci",
     "check": "node scripts/review-findings.mjs check",
+    "verify:docs": "node scripts/review-findings.mjs docs",
     "test:expensive": "node scripts/expensive-headless-acceptance.mjs",
-    "test:ab": "node scripts/ab-headless-trajectories.mjs"
+    "test:ab": "node scripts/ab-headless-trajectories.mjs",
+    "test:package:consumer": "node scripts/npm-consumer-smoke.mjs"
   },
   "keywords": [
     "deepseek-harness",
@@ -155,6 +152,18 @@
     }
   },
   "devDependencies": {
+    "@babel/core": "^7.29.7",
+    "@babel/generator": "^7.29.8",
+    "@babel/helper-create-class-features-plugin": "^7.29.7",
+    "@babel/plugin-proposal-decorators": "^7.29.7",
+    "@babel/plugin-transform-explicit-resource-management": "^7.29.7",
+    "@babel/plugin-transform-optional-chaining": "^7.29.7",
+    "@babel/plugin-transform-typescript": "^7.29.7",
+    "@babel/traverse": "^7.29.0",
+    "@codemirror/lang-javascript": "^6.2.5",
+    "@codemirror/language": "^6.12.4",
+    "@codemirror/state": "^6.7.4",
+    "@codemirror/view": "^6.43.11",
     "@deepseek-ai/dsh": "next",
     "@deepseek-ai/dsh-agent-loop": "next",
     "@deepseek-ai/dsh-api-gateway": "next",
@@ -169,6 +178,7 @@
     "@deepseek-ai/dsh-client-ui-session": "next",
     "@deepseek-ai/dsh-client-ui-slots": "next",
     "@deepseek-ai/dsh-commands": "next",
+    "@deepseek-ai/dsh-compaction-image-offload": "next",
     "@deepseek-ai/dsh-home-paths": "next",
     "@deepseek-ai/dsh-llm": "next",
     "@deepseek-ai/dsh-session-format-catalog": "next",
@@ -181,14 +191,19 @@
     "@deepseek-ai/dsh-typert-protocol": "next",
     "@deepseek-ai/dsh-typert-registry": "next",
     "@deepseek-ai/dsh-util-workspace-path": "next",
+    "@lezer/highlight": "^1.2.3",
+    "@radix-ui/react-select": "^2.2.6",
     "@shikijs/langs": "^4.3.1",
     "@testing-library/react": "^16.3.3",
+    "amaro": "1.1.11",
     "anser": "^2.3.5",
     "c8": "^12.0.0",
     "clsx": "^2.0.0",
+    "codemirror": "^6.0.2",
     "convert-source-map": "^2.0.0",
     "diff": "^9.0.0",
     "esbuild": "0.28.2",
+    "fflate": "^0.8.3",
     "immer": "^10.1.1",
     "jsdom": "^29.1.1",
     "katex": "^0.16.47",
@@ -203,11 +218,15 @@
     "micromark-util-classify-character": "^2.0.1",
     "micromark-util-sanitize-uri": "^2.0.1",
     "micromark-util-symbol": "^2.0.1",
+    "pathe": "^2.0.3",
     "playwright": "^1.63.0",
     "react": "^18.3.1",
     "react-dom": "^18.3.1",
+    "react-is": "^19.3.0",
     "shiki": "^4.3.1",
     "simple-icons": "16.31.0",
+    "tslib": "^2.8.1",
+    "typescript": "^6.0.3",
     "vitest": "^5.0.0",
     "yaml": "^2.9.0",
     "zustand": "~4.4.7"

package/src/client-activity.js

@@ -506,6 +506,7 @@ export function derivePtcToolView(block, toolName = undefined) {
     ? block.meta[GENERATED_RUN_CODE_DESCRIPTION_KEY]
     : undefined
   const description = (explicitDescription ?? generatedDescription)?.split(/\r?\n/, 1)[0] ?? ''
+  const descriptionGenerated = explicitDescription === undefined && generatedDescription !== undefined
   const output = settled ? resultText(block) : ''
   const state = !settled ? 'running'
     : block.error?.code === 'interrupted' ? 'stopped'
@@ -514,7 +515,7 @@ export function derivePtcToolView(block, toolName = undefined) {
     ? block.meta.dshPtcPlus
     : undefined
   if (journal === undefined) {
-    return Object.freeze({ state, description, code, output, ptc: false, features: Object.freeze([]) })
+    return Object.freeze({ state, description, descriptionGenerated, code, output, ptc: false, features: Object.freeze([]) })
   }
   const rewrites = isValidRewrites(block.meta.dshPtcPlusRewrites, journal)
     ? block.meta.dshPtcPlusRewrites
@@ -542,5 +543,5 @@ export function derivePtcToolView(block, toolName = undefined) {
       : undefined,
     ...operationFeatures(journal.operations),
   ])
-  return Object.freeze({ state, description, code, output, ptc: true, features: Object.freeze(features) })
+  return Object.freeze({ state, description, descriptionGenerated, code, output, ptc: true, features: Object.freeze(features) })
 }

package/src/client-authoring-view.js

@@ -1,5 +1,6 @@
 import { bindingDraftProjection, bindingReviewStatus } from './client-binding-review.js'
 import { bindingModelPreferences } from '../internal/user-binding-model-context.js'
+import { capabilityCommandText } from './client-capabilities-view.js'
 import { featureEnabled } from './client-feature-gates.js'
 import {
   MENU_CHILDREN_PROBE_SENTINEL,
@@ -25,7 +26,7 @@ export function createAuthoringView(React, deps) {
   const {
     ActionButton, IconButton, Menu, MenuFallback, Toast, Tooltip, CodeBlock, Modal, createPortal, BindingsDialog, PTCPlusSettingsDialog,
     useWorkbenchController, useBindingReview, catalogOwner, callUserBindings, subscribeReset,
-    settingsCardSeat, updateSetting, menuChildren,
+    settingsCardSeat, updateSetting, updateCapabilityConfiguration, menuChildren, SessionCapabilityControls,
     icons: {
       sparkle: IconSparkle16, chevron: IconChevronDownOutline14,
       close: IconCloseOutline16, check: IconCheckOutline14,
@@ -64,10 +65,11 @@ export function createAuthoringView(React, deps) {
   }[settingsCardSeat?.()] ?? 'settings.menuEntry')
 
   function BindingAuthorButton({
-    sessionId, t, useInput, inputActions, usePtcSettings, useBindingCommand,
+    sessionId, t, useInput, inputActions, usePtcSettings, useBindingCommand, useCapabilityCommand,
   }) {
     const input = useInput?.(snapshot => snapshot)
     const available = useBindingCommand(snapshot => snapshot)
+    const capabilityAvailable = useCapabilityCommand?.(snapshot => snapshot) === true
     const settings = usePtcSettings(snapshot => snapshot)
     const [review, view] = useBindingReview(sessionId)
     const anchorRef = React.useRef(null)
@@ -84,6 +86,7 @@ export function createAuthoringView(React, deps) {
     const hoverTimer = React.useRef(undefined)
     const [menu, setMenu] = React.useState(null)
     const [managing, setManaging] = React.useState(false)
+    const [capabilitiesOpen, setCapabilitiesOpen] = React.useState(false)
     const [settingsOpen, setSettingsOpen] = React.useState(false)
     // The composer entry's four actions live in the host Menu's `children`
     // region. Preceding Clients accept that prop and mount nothing, so the entry
@@ -105,16 +108,25 @@ export function createAuthoringView(React, deps) {
     const catalogFocus = React.useRef(null)
     const toastSequence = React.useRef(0)
     const [toast, setToast] = React.useState(null)
-    const hasDraft = view.mounted && view.candidate !== null && view.action === null
+    const hasDraft = featureEnabled(settings, 'bindings') && view.mounted && view.candidate !== null && view.action === null
     const quickAccess = featureEnabled(settings, 'authorButton')
-    const canAuthor = quickAccess && available && typeof useInput === 'function' && typeof inputActions?.setDraft === 'function'
-    const menuOpen = (hasDraft || quickAccess) && view.reachable && !managing && !settingsOpen
+    const pluginEnabled = featureEnabled(settings, 'plugin') && (hasDraft || featureEnabled(settings, 'ptcMenu'))
+    const canPrefill = typeof useInput === 'function' && typeof inputActions?.setDraft === 'function'
+    const canAuthor = quickAccess && available && canPrefill
+    const canRefresh = pluginEnabled && settings.status === 'ready' && settings.writable === true
+      && capabilityAvailable && canPrefill
+    const menuOpen = pluginEnabled && view.reachable && !managing && !capabilitiesOpen && !settingsOpen
       && menu !== null && menu.key === view.candidateKey
     // The dialog owns the management session; losing the input surface only
     // suspends reads, so a draft survives a temporary Host takeover.
     const workbench = useWorkbenchController({
       enabled: quickAccess && managing, active: view.reachable, callUserBindings,
     })
+    React.useEffect(() => {
+      if (!quickAccess) {
+        setManaging(false)
+      }
+    }, [quickAccess])
     const refreshCatalog = React.useCallback(async (reload = false) => {
       if (reload) captureCatalogFocus()
       await catalogSource.read({ reload })
@@ -124,6 +136,7 @@ export function createAuthoringView(React, deps) {
         catalogSource.reset()
         setMenu(null)
         setManaging(false)
+        setCapabilitiesOpen(false)
         setSettingsOpen(false)
       }
       const unsubscribe = subscribeReset(reset)
@@ -135,9 +148,14 @@ export function createAuthoringView(React, deps) {
     const toggleBinding = async entry => {
       if (!catalogReady || !quickAccess) return
       captureCatalogFocus()
-      await catalogSource.write(() => callUserBindings(entry.enabled ? 'disable' : 'enable', {
+      const next = await catalogSource.write(() => callUserBindings(entry.enabled ? 'disable' : 'enable', {
         id: entry.id, expectedRevision: catalog.revision,
       }))
+      const saved = next?.entries.find(item => item.id === entry.id)
+      if (saved) {
+        toastSequence.current++
+        setToast({ sequence: toastSequence.current, key: saved.enabled ? 'bindings.toggleEnabled' : 'bindings.toggleDisabled', params: { name: saved.name } })
+      }
     }
     const cancelHoverOpen = React.useCallback(() => {
       if (hoverTimer.current === undefined) return
@@ -260,13 +278,12 @@ export function createAuthoringView(React, deps) {
       return () => clearTimeout(timer)
     }, [toast])
     const label = hasDraft ? t('bindings.reviewMenuLabel', { count: 1 })
-      + (view.message ? ` · ${t('bindings.reviewAttention')}` : '') : t('bindings.open')
-    const hint = t(hasDraft ? 'bindings.draftHint' : 'bindings.openHint')
-    // Every authoring action goes through the same busy guard and input owner, so a
-    // new or revision request can never overwrite an unsent user draft.
-    const prefillAuthoring = value => {
+      + (view.message ? ` · ${t('bindings.reviewAttention')}` : '') : t(quickAccess ? 'bindings.open' : 'settings.toolsMenu')
+    const hint = t(hasDraft ? 'bindings.draftHint' : quickAccess ? 'bindings.openHint' : 'settings.toolsMenu')
+    // Command shortcuts share the composer guard; submission remains the user's action.
+    const prefillCommand = (value, allowed) => {
       hideMenu()
-      if (!canAuthor) return
+      if (!allowed) return
       if (typeof input?.draft === 'string' && input.draft.trim() !== '') {
         toastSequence.current += 1
         setToast({ sequence: toastSequence.current, text: t('bindings.composerBusy') })
@@ -274,8 +291,8 @@ export function createAuthoringView(React, deps) {
       }
       inputActions.setDraft(value)
     }
-    const openAuthoring = () => prefillAuthoring('/binding new ')
-    const openAuthoringEdit = entry => prefillAuthoring(`/binding edit ${entry.id} `)
+    const openAuthoring = () => prefillCommand('/binding new ', canAuthor)
+    const openAuthoringEdit = entry => prefillCommand(`/binding edit ${entry.id} `, canAuthor)
     const starButton = h('button', {
       type: 'button', className: 'ptcPlusAuthorButton', 'aria-label': label,
       // Older UI-kit lines ship no Tooltip primitive; the native title carries the hint there.
@@ -309,7 +326,6 @@ export function createAuthoringView(React, deps) {
     const enabledEntries = (catalog?.entries ?? []).filter(entry => entry.enabled)
     const disabledEntries = (catalog?.entries ?? []).filter(entry => !entry.enabled)
     const catalogItems = !quickAccess ? [] : [
-      { id: 'global-heading', type: 'label', text: t('bindings.quickHeading') },
       ...(catalog === null || catalog.entries.length === 0 ? [] : [
         { id: 'enabled-heading', type: 'label', text: t('bindings.quickEnabled', { count: enabledEntries.length }) },
         ...enabledEntries.map(catalogRow),
@@ -335,14 +351,7 @@ export function createAuthoringView(React, deps) {
     // submenu here would lose the bounded, scrollable catalog this step needs.
     const editItems = [
       { id: 'edit-heading', type: 'label', text: t('bindings.quickEditHeading') },
-      ...(catalog?.entries ?? []).map(entry => ({
-        id: `edit:${entry.id}`,
-        disabled: catalog === null,
-        label: h('span', { className: 'ptcPlusBindingQuickRow' },
-          h('span', { className: 'ptcPlusBindingQuickName' }, h('strong', { title: entry.name }, entry.name),
-            h('span', { className: 'ptcPlusBindingQuickState' }, t(entry.enabled ? 'bindings.enabled' : 'bindings.disabledEntry'))),
-          h('span', { className: 'ptcPlusBindingQuickPurpose', title: entry.purpose }, entry.purpose)),
-      })),
+      ...(catalog?.entries ?? []).map(entry => ({ ...catalogRow(entry), id: `edit:${entry.id}` })),
     ]
     const selectMenuItem = id => {
       if (!anchorRef.current?.getClientRects().length) return
@@ -371,6 +380,8 @@ export function createAuthoringView(React, deps) {
         setSettingsOpen(true)
         return
       }
+      if (id === 'capabilities') { hideMenu(); setCapabilitiesOpen(true); return }
+      if (id === 'refresh') { prefillCommand('/capabilities refresh', canRefresh); return }
       hideMenu()
       if (id === 'new') openAuthoring()
       else if (id === 'manage') {
@@ -381,12 +392,27 @@ export function createAuthoringView(React, deps) {
     }
     // One copy of each action label serves the grid the plugin renders itself,
     // in whichever carrier the installed Menu publishes for it.
-    const actionCopy = (id, copy) => h('span', {
+    const actionPaths = {
+      new: 'M8 3v10M3 8h10',
+      edit: 'm10 3 3 3M3 13l3-.7 7-7a1.4 1.4 0 0 0-3-3l-7 7L3 13Z',
+      refresh: 'M13 6a5 5 0 0 0-9-2L2 6m0-3v3h3M3 10a5 5 0 0 0 9 2l2-2m0 3v-3h-3',
+      manage: 'M2 4h5l1.5 2H14v7H2V4Z',
+      capabilities: 'M3 4h10M3 8h10M3 12h10M6 2v4M10 6v4M6 10v4',
+      settings: 'M6 2h4l.5 2 1.5 1.5 2 .5v4l-2 .5-1.5 1.5-.5 2H6l-.5-2L4 10.5 2 10V6l2-.5L5.5 4 6 2ZM10 8a2 2 0 1 0-4 0 2 2 0 0 0 4 0Z',
+      'edit-back': 'm7 3-5 5 5 5M2 8h12',
+    }
+    const actionCopy = (id, copy) => h(React.Fragment, null,
+      h('svg', { className: 'ptcPlusMenuActionIcon', width: 16, height: 16, viewBox: '0 0 16 16',
+        fill: 'none', 'aria-hidden': true }, h('path', { d: actionPaths[id], stroke: 'currentColor',
+        strokeWidth: 1.4, strokeLinecap: 'round', strokeLinejoin: 'round' })), h('span', {
       className: 'ptcPlusBindingMenuAction',
       title: id === 'settings' ? settingsPath(t) : undefined,
-    }, t(copy))
+    }, t(copy)))
     const actionButton = (id, copy) => h('button', {
       type: 'button', role: 'menuitem', className: 'ptcPlusMenuButton',
+      disabled: id === 'refresh' && !canRefresh,
+      title: id === 'refresh' && !capabilityAvailable ? t('capabilities.refreshUnavailable')
+        : id === 'settings' ? settingsPath(t) : t(copy),
       onClick: () => selectMenuItem(id),
     }, actionCopy(id, copy))
     const actionSections = [
@@ -396,7 +422,9 @@ export function createAuthoringView(React, deps) {
           actionButton('new', 'bindings.authorNewDraft'),
           (catalog?.entries?.length ?? 0) > 0 ? actionButton('edit', 'bindings.authorEdit') : null)) : null,
       h('div', { key: 'utilities', className: 'ptcPlusMenuUtilities' },
+        actionButton('refresh', 'capabilities.applySession'),
         quickAccess ? actionButton('manage', 'bindings.manage') : null,
+        SessionCapabilityControls ? actionButton('capabilities', 'capabilities.quick.title') : null,
         actionButton('settings', 'settings.menuEntry')),
     ]
     const menuEntries = menu?.step === 'edit' ? editItems : [
@@ -421,7 +449,8 @@ export function createAuthoringView(React, deps) {
         : entry.type === 'label'
           ? h('div', { key: entry.id, className: 'ptcPlusMenuGroupLabel' }, entry.text)
           : h('button', {
-            key: entry.id, type: 'button', role: 'menuitem', className: 'ptcPlusOwnedMenuRow',
+            key: entry.id, type: 'button', role: 'menuitem',
+            className: entry.id === 'disabled-group' ? 'ptcPlusOwnedMenuRow ptcPlusMenuDisclosure' : 'ptcPlusOwnedMenuRow',
             disabled: entry.disabled, 'data-binding-id': entry.bindingId,
             ref: entry.id === 'reload' ? reloadItemRef : entry.id === 'disabled-group' ? disabledGroupRef : undefined,
             'aria-expanded': entry.id === 'disabled-group' ? disabledOpen : undefined,
@@ -435,7 +464,7 @@ export function createAuthoringView(React, deps) {
       'data-text': isHostIconComponent(IconSparkle16) ? undefined : true,
       ref: attachAnchor,
     },
-      !hasDraft && !quickAccess ? null : h(menuChildrenRegion ? Menu : MenuFallback, {
+      !pluginEnabled ? null : h(menuChildrenRegion ? Menu : MenuFallback, {
         className: 'ptcPlusAuthorButtonShell', open: menuOpen,
         anchor: isHostComponent(Tooltip)
           ? h(Tooltip, { label: hint, delayMs: 700, disabled: menuOpen || managing || settingsOpen }, starButton) : starButton,
@@ -465,9 +494,17 @@ export function createAuthoringView(React, deps) {
           controller: workbench, t, onClose: () => setManaging(false), returnFocusRef: dialogReturnFocus,
           getReturnFocus: () => anchorRef.current?.querySelector('.ptcPlusAuthorButton'),
         }) : null,
+      SessionCapabilityControls && capabilitiesOpen && view.reachable
+        ? h(SessionCapabilityControls, { sessionId, open: true, t,
+          enabled: pluginEnabled && settings.status === 'ready' && settings.writable === true,
+          onClose: () => {
+            setCapabilitiesOpen(false)
+            queueMicrotask(() => anchorRef.current?.querySelector('.ptcPlusAuthorButton')
+              ?.focus({ preventScroll: true }))
+          } }) : null,
       settingsOpen && view.reachable
         ? h(PTCPlusSettingsDialog, {
-          t, usePtcSettings, updateSetting, callUserBindings,
+          t, usePtcSettings, updateSetting, updateCapabilityConfiguration, callUserBindings,
           onClose: () => {
             setSettingsOpen(false)
             queueMicrotask(() => anchorRef.current?.querySelector('.ptcPlusAuthorButton')
@@ -477,13 +514,13 @@ export function createAuthoringView(React, deps) {
       toast === null ? null : isHostComponent(Toast)
         ? h(Toast, {
           key: toast.sequence,
-          text: toast.text,
+          text: toast.key ? t(toast.key, toast.params) : capabilityCommandText(t, toast.text),
           anchor: anchorRef.current,
           onDone: () => setToast(null),
         })
         : h('span', {
           key: toast.sequence, className: 'ptcPlusComposerNotice', role: 'status',
-        }, toast.text))
+        }, toast.key ? t(toast.key, toast.params) : capabilityCommandText(t, toast.text)))
   }
 
   function BindingCandidateContent({ candidate, t, showName = true }) {

package/src/client-binding-review.js

@@ -202,7 +202,8 @@ export function createBindingReviews(call) {
         return () => {
           attached = false
           invalidate()
-          publish({ mounted: false, reachable: false, writable: false })
+          // The composer observer owns reachability independently of draft mounting.
+          publish({ mounted: false, writable: false })
         }
       },
       reset() {

package/src/client-binding-toggle.js

@@ -0,0 +1,18 @@
+import { readBindingToggle } from '../internal/binding-toggle-receipt.js'
+
+/** A separate Chat node keeps configuration receipts distinct from ordinary hidden contexts. */
+export const bindingToggleConversationDefinition = Object.freeze({
+  kind: 'ptc-plus-binding-toggle', target: 'chat',
+  match(event) {
+    return event.type === 'user/message' && event.surfaceOp === 'append' && readBindingToggle(event.data)
+      ? { id: event.data.id, role: 'start' } : null
+  },
+  start(_context, match) { return { seq: match.event.seq, receipt: readBindingToggle(match.event.data) } },
+  update(context) { return context.state },
+  buildViewNode(context) {
+    if (!context.state?.receipt) return null
+    return { key: context.key, id: context.id, kind: 'ptc-plus-binding-toggle', target: 'chat',
+      anchorSeq: context.state.seq, location: context.start?.location ?? { kind: 'unresolved' },
+      visibility: 'visible', data: context.state.receipt }
+  },
+})