dsh-ptc-plus 0.4.8 → 0.5.0

package/internal/user-bindings-owner.js

@@ -1,4 +1,5 @@
 import { PTC_MESSAGE_SOURCE_KIND } from './message-sources.js'
+import { bindingToggleMessage, readBindingToggle } from './binding-toggle-receipt.js'
 import { RPC_CONTRACTS } from './rpc-contract.js'
 import { randomUUID } from 'node:crypto'
 import { dirname } from 'node:path'
@@ -185,6 +186,7 @@ export function createUserBindingsOwner(ctx, options = {}) {
     valueLimits: options.valueLimits,
   }
   let disposed = false
+  const pendingConfigurationReceipts = new WeakMap()
   const codeConsole = new UserBindingConsole(currentOptions)
   const commandRegistrations = new Map()
   const sessionAgents = new Map()
@@ -274,7 +276,7 @@ export function createUserBindingsOwner(ctx, options = {}) {
     entry: current.entry,
   })
   const candidateView = current => Object.freeze({ requestId: current.requestId, commandId: current.commandId, ...draftView(current) })
-  const settleDraft = (current, state, enabled = false) => {
+  const settleDraft = async (current, state, enabled = false) => {
     const retainReview = draftsByCapability.get(current.capability) === current
     removeDraft(current)
     const action = Object.freeze({ requestId: current.requestId, id: current.entry.id, state, enabled })
@@ -282,7 +284,8 @@ export function createUserBindingsOwner(ctx, options = {}) {
       reviewsByCapability.set(current.capability, { agent: current.agent, candidate: candidateView(current), action })
     }
     try {
-      const accepting = sessionEvents(current.agent.session)?.find(event => (
+      const sessionLog = await (options.readSessionLog ?? (async session => session))(current.agent.session)
+      const accepting = sessionEvents(sessionLog)?.find(event => (
         event.type === 'tool/result' && event.surfaceOp === 'append'
         && event.data?.meta?.[USER_BINDING_DRAFT_META_KEY]?.candidate?.requestId === current.requestId
       ))
@@ -303,7 +306,7 @@ export function createUserBindingsOwner(ctx, options = {}) {
       drafts.delete(current.sessionId)
     }
   }
-  const clearDraft = (capability, version) => {
+  const clearDraft = async (capability, version) => {
     const current = draftFor(capability)
     if (current === null) return null
     if (!Number.isSafeInteger(version) || version < 1 || version !== current.version) {
@@ -314,7 +317,7 @@ export function createUserBindingsOwner(ctx, options = {}) {
     if (current.state !== 'ready') {
       throw Object.assign(new Error('binding draft is being saved'), { code: 'BINDINGS_BUSY' })
     }
-    settleDraft(current, 'discarded')
+    await settleDraft(current, 'discarded')
     return null
   }
   const saveDraft = async (capability, version, expectedRevision, activate = false) => {
@@ -333,7 +336,7 @@ export function createUserBindingsOwner(ctx, options = {}) {
       const result = current.mode === 'new'
         ? await store.create(entry, expectedRevision)
         : await store.update(entry, expectedRevision)
-      settleDraft(current, 'saved', activate === true)
+      await settleDraft(current, 'saved', activate === true)
       return result
     } catch (error) {
       if (drafts.get(current.sessionId) === current && current.state === 'saving') {
@@ -377,13 +380,33 @@ export function createUserBindingsOwner(ctx, options = {}) {
   }
   // Fixed endpoint tables grouped by domain; the dispatcher only looks up the
   // operation, rejects unknown endpoints and hands over the validated input.
+  const setEnabled = async (input, requested) => {
+    const next = await store.setEnabled(input.id, requested, input.expectedRevision)
+    const entry = next.entries.find(entry => entry.id === input.id)
+    if (entry === undefined) throw new Error('saved binding missing from confirmed catalog')
+    const sessions = new Set((ctx.agents?.list?.() ?? []).map(agent => agent.session).filter(Boolean))
+    for (const session of sessions) {
+      try {
+        const message = createUserMessage(bindingToggleMessage(entry, next.revision))
+        // The Host alone establishes the first system head. Before that accepted
+        // boundary, keep UI configuration facts pending without waking the Agent.
+        if (session.deriveMessages()[0]?.role === 'system') session.append('user/message', message, { surfaceOp: 'append' })
+        else {
+          const pending = pendingConfigurationReceipts.get(session) ?? []
+          pending.push(message)
+          pendingConfigurationReceipts.set(session, pending)
+        }
+      } catch (error) { reportContainedFailure('ptc-plus: binding configuration saved but its session receipt could not be appended', error) }
+    }
+    return next
+  }
   const storageEndpoints = Object.freeze({
     list: () => store.list(),
     load: input => store.entry(input.id),
     reload: () => store.reload(),
     save: saveEntry,
-    enable: input => store.setEnabled(input.id, true, input.expectedRevision),
-    disable: input => store.setEnabled(input.id, false, input.expectedRevision),
+    enable: input => setEnabled(input, true),
+    disable: input => setEnabled(input, false),
     remove: input => store.remove(input.id, input.expectedRevision),
     import: input => store.importFile(input.path, input.expectedRevision, input.options),
     validate: input => validateEntry(input.entry),
@@ -893,6 +916,23 @@ export function createUserBindingsOwner(ctx, options = {}) {
   mountAuthoring()
 
   return Object.freeze({
+    committedEvent(session, event) {
+      if (event.type !== 'user/message' || !readBindingToggle(event.data)) return
+      const pending = pendingConfigurationReceipts.get(session)
+      if (pending) pendingConfigurationReceipts.set(session, pending.filter(message => message.id !== event.data.id))
+    },
+    async preStep(payload, next) {
+      const decision = await next()
+      if (disposed || decision?.kind !== 'enter' || payload.signal?.aborted || payload.agent?.signal?.aborted) return decision
+      const session = payload.agent?.session
+      const pending = pendingConfigurationReceipts.get(session)
+      if (!pending?.length) return decision
+      const visible = new Set(session.deriveMessages().map(message => message.id))
+      const remaining = pending.filter(message => !visible.has(message.id))
+      pendingConfigurationReceipts.set(session, remaining)
+      const proposed = new Set((decision.messages ?? []).map(message => message.id))
+      return { ...decision, messages: [...(decision.messages ?? []), ...remaining.filter(message => !proposed.has(message.id))] }
+    },
     path: store.filename,
     cwd: bindingsCwd,
     async snapshot() {

package/internal/validated-parse-repair.js

@@ -53,7 +53,7 @@ function renderInvocation(argumentsValue) {
   const json = JSON.stringify(argumentsValue)
     .replaceAll('\u2028', '\\u2028')
     .replaceAll('\u2029', '\\u2029')
-  return `edit_run_code(${json})`
+  return `await tools.edit_run_code(${json})`
 }
 
 /** Requires exactly one valid suffix across all one- and two-token EOF closures. */

package/internal/value-wire.js

@@ -1,3 +1,4 @@
+import { types } from 'node:util'
 import { assertFields, isRecord } from './record-utils.js'
 import { runtimeIntrinsics as internal } from './runtime-intrinsics.js'
 import {
@@ -23,6 +24,9 @@ const intrinsicFunctionToString = Function.prototype.toString
 const reflectApply = Reflect.apply
 const bufferByteLength = internal.bufferByteLength
 const jsonStringify = JSON.stringify
+const { isProxy, isDate, isMap, isSet, isRegExp, isAnyArrayBuffer, isTypedArray,
+  isDataView, isNativeError, isPromise, isWeakMap, isWeakSet } = types
+const encodingFailures = new WeakMap()
 
 function limitsOf(options = {}) {
   const limits = { ...DEFAULT_VALUE_LIMITS, ...options }
@@ -36,19 +40,16 @@ function limitsOf(options = {}) {
 }
 
 function hasIntrinsicConstructor(prototype, name) {
+  if (isProxy(prototype)) return false
   const constructor = Object.getOwnPropertyDescriptor(prototype, 'constructor')?.value
-  if (typeof constructor !== 'function') return false
-  try {
-    return constructor.name === name
-      && constructor.prototype === prototype
-      && reflectApply(intrinsicFunctionToString, constructor, []) === `function ${name}() { [native code] }`
-  } catch {
-    return false
-  }
+  if (typeof constructor !== 'function' || isProxy(constructor)) return false
+  return Object.getOwnPropertyDescriptor(constructor, 'name')?.value === name
+    && Object.getOwnPropertyDescriptor(constructor, 'prototype')?.value === prototype
+    && reflectApply(intrinsicFunctionToString, constructor, []) === `function ${name}() { [native code] }`
 }
 
 function isIntrinsicObjectPrototype(value) {
-  return Object.getPrototypeOf(value) === null && hasIntrinsicConstructor(value, 'Object')
+  return !isProxy(value) && Object.getPrototypeOf(value) === null && hasIntrinsicConstructor(value, 'Object')
 }
 
 function plainObjectPrototype(value) {
@@ -66,8 +67,53 @@ function hasPlainArrayPrototype(value) {
     && isIntrinsicObjectPrototype(objectPrototype)
 }
 
-function invalid(path, detail) {
-  throw new TypeError(`value at ${path} is not PTC Value V1: ${detail}`)
+function invalid(path, detail, kind = 'shape', legacyDetail = detail, legacyMessage = `value at ${path} is not PTC Value V1: ${legacyDetail}`) {
+  const error = new TypeError(`value at ${path} is not PTC Value V1: ${detail}`)
+  weakMapSet(encodingFailures, error, { kind, path, detail, legacyMessage })
+  throw error
+}
+
+/** Brand checks do not read constructor, toStringTag, getters, or Proxy traps. */
+function unsupportedObject(value) {
+  if (isProxy(value)) return 'Proxy'
+  if (isDate(value)) return 'Date'
+  if (isMap(value)) return 'Map'
+  if (isSet(value)) return 'Set'
+  if (isRegExp(value)) return 'RegExp'
+  if (isAnyArrayBuffer(value)) return 'ArrayBuffer/SharedArrayBuffer'
+  if (isTypedArray(value)) return 'TypedArray/Buffer'
+  if (isDataView(value)) return 'DataView'
+  if (isNativeError(value)) return 'Error'
+  if (isPromise(value)) return 'Promise'
+  if (isWeakMap(value)) return 'WeakMap'
+  if (isWeakSet(value)) return 'WeakSet'
+  return 'unknown prototype'
+}
+
+export function valueEncodingFailure(error) {
+  return weakMapGet(encodingFailures, error)
+}
+
+export function valueEncodingHelp(failure) {
+  return failure?.kind === 'budget'
+    ? 'reduce the transferred graph to fit the reported value budget'
+    : 'select needed data explicitly as supported primitives, plain objects or arrays; keep unsupported live values in bindings (Date: explicit ISO text or timestamp; Map/Set: explicit entries or values); do not JSON.stringify a graph containing BigInt'
+}
+
+/** Only codec-owned failures acquire boundary facts; owner exceptions remain untouched. */
+export function encodeValueAtBoundary(value, options, boundary) {
+  try {
+    return encodeValue(value, options)
+  } catch (error) {
+    const failure = valueEncodingFailure(error)
+    if (failure === undefined) throw error
+    const fact = boundary === 'parameter'
+      ? 'program binding parameter was not dispatched'
+      : 'program binding call completed, but its result could not be transferred; external effects may already have occurred; do not repeat the operation solely to obtain its result'
+    const wrapped = new TypeError(`${fact}: ${error.message}; ${valueEncodingHelp(failure)}`)
+    weakMapSet(encodingFailures, wrapped, failure)
+    throw wrapped
+  }
 }
 
 function stringBytes(value) {
@@ -86,7 +132,7 @@ export function encodeValue(value, options = {}) {
 
   const accountText = (text, path) => {
     textBytes += stringBytes(text)
-    if (textBytes > limits.maxStringBytes) invalid(path, `string budget exceeds ${limits.maxStringBytes} bytes`)
+    if (textBytes > limits.maxStringBytes) invalid(path, `string budget exceeds ${limits.maxStringBytes} bytes`, 'budget')
   }
 
   const atom = (current, path) => {
@@ -106,14 +152,14 @@ export function encodeValue(value, options = {}) {
     if (typeof current === 'bigint') {
       const text = toString(current)
       const digits = text[0] === '-' ? text.length - 1 : text.length
-      if (digits > limits.maxBigIntDigits) invalid(path, `BigInt exceeds ${limits.maxBigIntDigits} digits`)
+      if (digits > limits.maxBigIntDigits) invalid(path, `BigInt exceeds ${limits.maxBigIntDigits} digits`, 'budget')
       accountText(text, path)
       return { tag: 'bigint', value: text }
     }
-    if (typeof current !== 'object') invalid(path, typeof current)
+    if (typeof current !== 'object') invalid(path, typeof current, 'unsupported')
     const prior = weakMapGet(seen, current)
     if (prior !== undefined) return { tag: 'reference', index: prior }
-    if (nodes.length >= limits.maxNodes) invalid(path, `node budget exceeds ${limits.maxNodes}`)
+    if (nodes.length >= limits.maxNodes) invalid(path, `node budget exceeds ${limits.maxNodes}`, 'budget')
     const index = nodes.length
     weakMapSet(seen, current, index)
     appendArray(nodes, undefined)
@@ -127,10 +173,10 @@ export function encodeValue(value, options = {}) {
     const current = item.value
     if (isArray(current)) {
       if (!hasPlainArrayPrototype(current)) invalid(item.path, 'non-plain array')
-      if (current.length > limits.maxArrayLength) invalid(item.path, `array length exceeds ${limits.maxArrayLength}`)
+      if (current.length > limits.maxArrayLength) invalid(item.path, `array length exceeds ${limits.maxArrayLength}`, 'budget')
       arraySlotCount += current.length
       if (arraySlotCount > limits.maxArrayLength) {
-        invalid(item.path, `array slot budget exceeds ${limits.maxArrayLength}`)
+        invalid(item.path, `array slot budget exceeds ${limits.maxArrayLength}`, 'budget')
       }
       const entries = []
       const keys = Reflect.ownKeys(current)
@@ -147,7 +193,7 @@ export function encodeValue(value, options = {}) {
           invalid(`${item.path}[${key}]`, 'array index must be an enumerable data property')
         }
         edgeCount += 1
-        if (edgeCount > limits.maxEdges) invalid(item.path, `edge budget exceeds ${limits.maxEdges}`)
+        if (edgeCount > limits.maxEdges) invalid(item.path, `edge budget exceeds ${limits.maxEdges}`, 'budget')
         appendArray(entries, [index, atom(descriptor.value, `${item.path}[${key}]`)])
       }
       nodes[item.index] = { type: 'array', length: current.length, entries }
@@ -155,7 +201,7 @@ export function encodeValue(value, options = {}) {
     }
 
     const prototype = plainObjectPrototype(current)
-    if (prototype === undefined) invalid(item.path, 'non-plain object')
+    if (prototype === undefined) invalid(item.path, `non-plain object (${unsupportedObject(current)})`, 'unsupported', 'non-plain object')
     const entries = []
     const keys = Reflect.ownKeys(current)
     for (let keyIndex = 0; keyIndex < keys.length; keyIndex += 1) {
@@ -167,7 +213,7 @@ export function encodeValue(value, options = {}) {
       }
       accountText(key, `${item.path}.${key}`)
       edgeCount += 1
-      if (edgeCount > limits.maxEdges) invalid(item.path, `edge budget exceeds ${limits.maxEdges}`)
+      if (edgeCount > limits.maxEdges) invalid(item.path, `edge budget exceeds ${limits.maxEdges}`, 'budget')
       appendArray(entries, [key, atom(descriptor.value, `${item.path}.${key}`)])
     }
     nodes[item.index] = { type: 'object', prototype, entries }
@@ -442,7 +488,8 @@ function renderCanonicalValue(normalized, limits) {
   let bytes = 0
   const append = (text) => {
     bytes += stringBytes(text)
-    if (bytes > limits.maxStringBytes) throw new TypeError(`rendered PTC value exceeds ${limits.maxStringBytes} bytes`)
+    if (bytes > limits.maxStringBytes) invalid('$', `rendered PTC value exceeds ${limits.maxStringBytes} bytes`, 'budget', undefined,
+      `rendered PTC value exceeds ${limits.maxStringBytes} bytes`)
     appendArray(chunks, text)
   }
   const emitted = new Set()

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/locale/en.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "PTC Plus",
+    "description": "A session-bound agent-native REPL for DeepSeek Harness PTC mode."
+  }
+}

package/locale/zh.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "PTC Plus",
+    "description": "面向 DeepSeek Harness PTC 模式的会话级 Agent 原生 REPL。"
+  }
+}

package/package.json

@@ -1,18 +1,20 @@
 {
   "name": "dsh-ptc-plus",
-  "version": "0.4.8",
+  "version": "0.5.0",
   "icon": "assets/ptc-plus-icon.svg",
   "description": "A session-bound agent-native REPL for DeepSeek Harness PTC mode.",
   "type": "module",
   "main": "./index.js",
   "exports": {
     ".": "./index.js",
-    "./client": "./client.js",
-    "./package.json": "./package.json"
+    "./execution-provider": "./internal/execution-provider-owner.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",
@@ -29,15 +31,12 @@
     "assets/ptc-plus-icon.svg",
     "assets/dsh-ptc-plus-banner-en.webp",
     "assets/dsh-ptc-plus-banner-zh.webp",
-    "assets/ptc-plus-bindings-en.png",
-    "assets/ptc-plus-bindings-zh.png",
-    "assets/ptc-plus-repair-zh.png",
-    "assets/ptc-plus-repair-en.png",
     "assets/ptc-plus-repl-workspace-en.png",
     "assets/ptc-plus-repl-workspace-zh.png",
     "assets/ptc-plus-settings-en.png",
     "assets/ptc-plus-settings-zh.png",
     "cordis.patch.yml",
+    "locale",
     "README.md",
     "README.en.md",
     "LICENSE"
@@ -50,36 +49,24 @@
   },
   "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/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",
-    "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": "*"
@@ -88,10 +75,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:semantics": "node --test --test-concurrency=1 test/semantic-test262.test.js test/semantic-dialect.test.js test/semantic-boundaries.test.js",
+    "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 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",
@@ -109,12 +104,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 && 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 && 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",
@@ -139,23 +138,31 @@
     },
     "client": {
       "platform": "web",
-      "external": [
-        "react"
-      ],
+      "immediately": true,
       "inject": [
         "@deepseek-ai/dsh-api-gateway",
         "@deepseek-ai/dsh-api-remotes",
-        "@deepseek-ai/dsh-client-runtime",
         "@deepseek-ai/dsh-client-locale",
         "@deepseek-ai/dsh-client-ui-settings",
         "@deepseek-ai/dsh-client-ui-settings-plugins",
         "@deepseek-ai/dsh-client-ui-conversation",
-        "@deepseek-ai/dsh-client-connection",
-        "@deepseek-ai/dsh-client-ui-primitives"
+        "@deepseek-ai/dsh-client-connection"
       ]
     }
   },
   "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",
@@ -170,6 +177,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",
@@ -182,14 +190,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",
@@ -204,11 +217,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"