@norman-else/dsh-claude 0.1.6 → 0.1.7

package/README.md

@@ -9,8 +9,8 @@ Run the local Claude Code CLI as a first-class main conversation inside DeepSeek
 - A `Claude` Agent Preset in the normal new-session preset picker.
 - A `claude` DSH model provider with Claude Code's `default`, `opus[1m]`, `fable`, `sonnet`, and `haiku` choices.
 - Long-lived Claude processes with per-session serialization, idle eviction, cancellation, and persisted Claude session resume.
-- DSH approval prompts for Claude tool permission requests.
-- Durable, redacted plugin-sidecar activity for thinking summaries, tool calls/results, permissions, subagents, status, usage, and errors.
+- DSH approval prompts for Claude tool permission requests and native DSH question forms for Claude clarifications.
+- Durable, redacted plugin-sidecar activity for thinking summaries, tool calls/results, permissions, question lifecycle, subagents, status, usage, and errors.
 - Native turn-tail activity cards and a Settings → Claude Code Doctor panel.
 - A safe CLI for Doctor and managed preset install/remove.
 
@@ -41,7 +41,7 @@ The package ships a read-only system preset and, during Host activation, install
 2. Choose **Claude** in the Agent Preset picker.
 3. Choose **Default (recommended)**, **Opus (1M context)**, **Fable**, **Sonnet**, or **Haiku**.
 4. Send a normal text prompt.
-5. Answer Claude tool permissions through the existing DSH approval UI.
+5. Answer Claude tool permissions through the existing DSH approval UI and Claude clarifying questions through DSH's native question form.
 6. Expand **Claude Code activity** beneath a completed assistant turn to inspect the redacted execution trail.
 
 Native DSH presets remain available and keep the native DSH agent loop.
@@ -60,6 +60,7 @@ Every Claude permission callback is bridged to `ctx.approval.request(...)`:
 - reject, cancel, missing answerer, and audit failure all deny the action.
 - DSH `never` approval policy therefore fails closed.
 - DSH access modes map to Claude permission modes: `read-only` → `plan`, `workspace-write` → `acceptEdits`, and explicitly acknowledged `danger-full-access` → `bypassPermissions`.
+- Claude `AskUserQuestion` is always routed to `ctx.userQuestions`, including under Full access; cancellation or an unavailable question surface denies the interaction, and answer content is not copied into the sidecar.
 
 This is a permission-policy bridge, not kernel-level workspace confinement. DSH `0.1.0-rc.5` exposes one writable sandbox root, while full Claude compatibility also requires writable `~/.claude`. The plugin therefore does **not** claim that paths outside the workspace are technically unwritable. It still uses DSH managed subprocess ownership for explicit argv, credential-shaped environment scrubbing, cancellation, and whole-process-tree termination.
 

package/lib/events-DP0Ov_Re.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"events-DP0Ov_Re.mjs","names":[],"sources":["../src/constants.ts","../src/events.ts"],"sourcesContent":["export const CLAUDE_CODE_PROVIDER = 'claude'\r\nexport const CLAUDE_CODE_PRESET_ID = 'claude'\r\nexport const CLAUDE_CODE_PROVIDER_IDS = [CLAUDE_CODE_PROVIDER] as const\r\nexport const CLAUDE_SESSION_BOUND_EVENT = 'claude-code/session-bound'\r\nexport const CLAUDE_ACTIVITY_EVENT = 'claude-code/activity'\r\nexport const CLAUDE_CONTEXT_USAGE_EVENT = 'claude-code/context-usage'\r\nexport const CLAUDE_TASKS_EVENT = 'claude-code/tasks'\r\n/** Claude's subagent dispatch tools; rendered as plugin-owned group cards\r\n *  gathering subagent activity instead of native tool cards. */\r\nexport const TASK_TOOL_NAMES: ReadonlySet<string> = new Set(['Task', 'Agent'])\r\nexport const SDK_VERSION = '0.3.233'\r\nexport const CLAUDE_DOCTOR_PATH = '/plugins/dsh-claude/doctor'\r\nexport const CLAUDE_PROJECTION_PATH = '/plugins/dsh-claude/projection'\r\n","import type { SessionEvent } from '@deepseek-ai/dsh-session'\r\nimport {\r\n  CLAUDE_ACTIVITY_EVENT,\r\n  CLAUDE_CONTEXT_USAGE_EVENT,\r\n  CLAUDE_SESSION_BOUND_EVENT,\r\n  CLAUDE_TASKS_EVENT,\r\n} from './constants.ts'\r\n\r\nexport type ClaudeActivityKind =\r\n  | 'status'\r\n  | 'thinking'\r\n  | 'tool-call'\r\n  | 'tool-result'\r\n  | 'permission'\r\n  | 'subagent'\r\n  | 'usage'\r\n  | 'warning'\r\n  | 'error'\r\n\r\nexport type ClaudeActivityPhase =\r\n  | 'started'\r\n  | 'updated'\r\n  | 'completed'\r\n  | 'denied'\r\n  | 'failed'\r\n\r\nexport interface ClaudeUsage {\r\n  inputTokens?: number\r\n  outputTokens?: number\r\n  cacheReadTokens?: number\r\n  cacheCreationTokens?: number\r\n  cumulativeCostUsd?: number\r\n}\r\n\r\nexport interface ClaudeSessionBoundEvent {\r\n  claudeSessionId: string\r\n  cliVersion?: string\r\n  sdkVersion: string\r\n  cwd: string\r\n}\r\n\r\nexport interface ClaudeActivityEvent {\r\n  turn: number\r\n  step: number\r\n  ordinal: number\r\n  kind: ClaudeActivityKind\r\n  phase?: ClaudeActivityPhase\r\n  /** Claude task-board identity for lifecycle activity; never a transcript path. */\r\n  taskId?: string\r\n  toolUseId?: string\r\n  /** Enclosing Claude tool call for subagent-nested activity. */\r\n  parentToolUseId?: string\r\n  toolName?: string\r\n  title?: string\r\n  summary?: string\r\n  detail?: string\r\n  isError?: boolean\r\n  usage?: ClaudeUsage\r\n}\r\n\r\nexport interface ClaudeContextUsageCategory {\r\n  name: string\r\n  tokens: number\r\n  color: string\r\n  isDeferred?: boolean\r\n}\r\n\r\nexport interface ClaudeContextUsageEvent {\r\n  model: string\r\n  totalTokens: number\r\n  maxTokens: number\r\n  percentage: number\r\n  categories: readonly ClaudeContextUsageCategory[]\r\n}\r\n\r\nexport interface ClaudeContextUsageInput {\r\n  model: unknown\r\n  totalTokens: unknown\r\n  maxTokens: unknown\r\n  percentage: unknown\r\n  categories: readonly {\r\n    name?: unknown\r\n    tokens?: unknown\r\n    color?: unknown\r\n    isDeferred?: unknown\r\n  }[]\r\n}\r\n\r\ndeclare module '@deepseek-ai/dsh-session/types' {\r\n  interface SessionEventMap {\r\n    'claude-code/session-bound': ClaudeSessionBoundEvent\r\n    'claude-code/activity': ClaudeActivityEvent\r\n    'claude-code/context-usage': ClaudeContextUsageEvent\r\n    'claude-code/tasks': ClaudeTasksEvent\r\n  }\r\n}\r\n\r\nconst SECRET_KEY = /(?:^|[_-])(password|passwd|secret|token|api[_-]?key|authorization|credential|private[_-]?key|session[_-]?key|env|environ|environment)(?:$|[_-])/i\r\nconst MAX_SUMMARY_CHARS = 1_000\r\nconst MAX_DETAIL_CHARS = 4_000\r\nconst MAX_DEPTH = 6\r\nconst MAX_ARRAY_ITEMS = 40\r\nconst MAX_OBJECT_KEYS = 60\r\nconst REDACTED = '[REDACTED]'\r\nconst TRUNCATED = '…[truncated]'\r\nconst SECRET_ASSIGNMENT = /((?:password|passwd|secret|token|api[_-]?key|authorization|credential|private[_-]?key|session[_-]?key)\\s*(?:=|:)\\s*)(?:\"[^\"]*\"|'[^']*'|[^\\s,;&]+)/giu\r\nconst BEARER_TOKEN = /(\\bbearer\\s+)[A-Za-z0-9._~+/=-]+/giu\r\nconst PREFIXED_TOKEN = /\\b(?:sk-(?:ant-|proj-)?|xox[baprs]-|ghp_|github_pat_)[A-Za-z0-9_-]{8,}/giu\r\nconst JWT_TOKEN = /\\beyJ[A-Za-z0-9_-]+\\.[A-Za-z0-9_-]+\\.[A-Za-z0-9_-]+\\b/gu\r\nconst URL_USERINFO = /([a-z][a-z0-9+.-]*:\\/\\/[^:\\s/@]+:)[^@\\s/]+@/giu\r\nconst URL_SECRET_PARAM = /([?&](?:password|secret|token|api[_-]?key|access[_-]?token|refresh[_-]?token)=)[^&#\\s]+/giu\r\n\r\nexport function boundText(value: string, maxChars: number): string {\r\n  if (value.length <= maxChars) return value\r\n  return `${value.slice(0, Math.max(0, maxChars - TRUNCATED.length))}${TRUNCATED}`\r\n}\r\n\r\nexport function redactText(value: string, maxChars = MAX_DETAIL_CHARS): string {\r\n  return boundText(\r\n    value\r\n      .replace(JWT_TOKEN, REDACTED)\r\n      .replace(PREFIXED_TOKEN, REDACTED)\r\n      .replace(BEARER_TOKEN, `$1${REDACTED}`)\r\n      .replace(URL_USERINFO, `$1${REDACTED}@`)\r\n      .replace(URL_SECRET_PARAM, `$1${REDACTED}`)\r\n      .replace(SECRET_ASSIGNMENT, `$1${REDACTED}`),\r\n    maxChars,\r\n  )\r\n}\r\n\r\nexport function redactValue(value: unknown, depth = 0, seen = new WeakSet<object>()): unknown {\r\n  if (depth > MAX_DEPTH) return '[max-depth]'\r\n  if (value === null || typeof value === 'boolean' || typeof value === 'number') return value\r\n  if (typeof value === 'string') return redactText(value)\r\n  if (typeof value === 'bigint') return value.toString()\r\n  if (typeof value === 'undefined') return null\r\n  if (typeof value === 'function' || typeof value === 'symbol') return `[${typeof value}]`\r\n  if (value instanceof Error) {\r\n    return { name: value.name, message: redactText(value.message, MAX_SUMMARY_CHARS) }\r\n  }\r\n  if (typeof value !== 'object') return String(value)\r\n  if (seen.has(value)) return '[circular]'\r\n  seen.add(value)\r\n  try {\r\n    if (Array.isArray(value)) {\r\n      const items = value.slice(0, MAX_ARRAY_ITEMS).map(item => redactValue(item, depth + 1, seen))\r\n      if (value.length > MAX_ARRAY_ITEMS) items.push(`[${value.length - MAX_ARRAY_ITEMS} more items]`)\r\n      return items\r\n    }\r\n    const result: Record<string, unknown> = {}\r\n    const entries = Object.entries(value as Record<string, unknown>)\r\n    for (const [key, item] of entries.slice(0, MAX_OBJECT_KEYS)) {\r\n      result[key] = SECRET_KEY.test(key) ? REDACTED : redactValue(item, depth + 1, seen)\r\n    }\r\n    if (entries.length > MAX_OBJECT_KEYS) result.__truncatedKeys = entries.length - MAX_OBJECT_KEYS\r\n    return result\r\n  } finally {\r\n    seen.delete(value)\r\n  }\r\n}\r\n\r\nexport function safeDetail(value: unknown): string | undefined {\r\n  if (value === undefined) return undefined\r\n  const redacted = redactValue(value)\r\n  const text = typeof redacted === 'string' ? redacted : JSON.stringify(redacted)\r\n  return boundText(text, MAX_DETAIL_CHARS)\r\n}\r\n\r\nexport function normalizeActivity(\r\n  activity: Omit<ClaudeActivityEvent, 'summary' | 'detail'> & {\r\n    summary?: unknown\r\n    detail?: unknown\r\n  },\r\n): ClaudeActivityEvent {\r\n  const normalized: ClaudeActivityEvent = {\r\n    turn: activity.turn,\r\n    step: activity.step,\r\n    ordinal: activity.ordinal,\r\n    kind: activity.kind,\r\n  }\r\n  if (activity.phase !== undefined) normalized.phase = activity.phase\r\n  if (activity.taskId !== undefined) normalized.taskId = redactText(activity.taskId, 128)\r\n  if (activity.toolUseId !== undefined) normalized.toolUseId = redactText(activity.toolUseId, 256)\r\n  if (activity.parentToolUseId !== undefined) normalized.parentToolUseId = redactText(activity.parentToolUseId, 256)\r\n  if (activity.toolName !== undefined) normalized.toolName = redactText(activity.toolName, 256)\r\n  if (activity.title !== undefined) normalized.title = redactText(activity.title, MAX_SUMMARY_CHARS)\r\n  if (activity.summary !== undefined) {\r\n    normalized.summary = redactText(\r\n      typeof activity.summary === 'string' ? activity.summary : safeDetail(activity.summary) ?? '',\r\n      MAX_SUMMARY_CHARS,\r\n    )\r\n  }\r\n  const detail = safeDetail(activity.detail)\r\n  if (detail !== undefined) normalized.detail = detail\r\n  if (activity.isError !== undefined) normalized.isError = activity.isError\r\n  if (activity.usage !== undefined) normalized.usage = { ...activity.usage }\r\n  return normalized\r\n}\r\n\r\nconst MAX_CONTEXT_CATEGORIES = 24\r\nconst FALLBACK_CONTEXT_COLOR = '#8b95a5'\r\nconst SAFE_CONTEXT_COLOR = /^#[0-9a-f]{3,8}$/iu\r\n\r\nfunction nonNegativeInteger(value: unknown): number {\r\n  return typeof value === 'number' && Number.isFinite(value)\r\n    ? Math.max(0, Math.floor(value))\r\n    : 0\r\n}\r\n\r\nexport function normalizeContextUsage(input: ClaudeContextUsageInput): ClaudeContextUsageEvent {\r\n  return {\r\n    model: redactText(typeof input.model === 'string' ? input.model : 'unknown', 128),\r\n    totalTokens: nonNegativeInteger(input.totalTokens),\r\n    maxTokens: nonNegativeInteger(input.maxTokens),\r\n    percentage: Math.min(100, nonNegativeInteger(input.percentage)),\r\n    categories: input.categories.slice(0, MAX_CONTEXT_CATEGORIES).map(category => ({\r\n      name: redactText(typeof category.name === 'string' ? category.name : 'Unknown', 128),\r\n      tokens: nonNegativeInteger(category.tokens),\r\n      color: typeof category.color === 'string' && SAFE_CONTEXT_COLOR.test(category.color)\r\n        ? category.color\r\n        : FALLBACK_CONTEXT_COLOR,\r\n      ...(category.isDeferred === true ? { isDeferred: true } : {}),\r\n    })),\r\n  }\r\n}\r\n\r\nexport function latestClaudeContextUsage(\r\n  events: readonly SessionEvent[],\r\n): ClaudeContextUsageEvent | undefined {\r\n  for (let index = events.length - 1; index >= 0; index -= 1) {\r\n    const event = events[index]\r\n    if (event?.type === CLAUDE_CONTEXT_USAGE_EVENT) return event.data as ClaudeContextUsageEvent\r\n  }\r\n  return undefined\r\n}\r\n\r\nexport type ClaudeTaskStatus = 'running' | 'completed' | 'failed' | 'stopped' | 'killed'\r\n\r\nexport interface ClaudeTaskUsage {\r\n  totalTokens?: number\r\n  toolUses?: number\r\n  durationMs?: number\r\n}\r\n\r\nexport interface ClaudeTaskInfo {\r\n  taskId: string\r\n  description: string\r\n  status: ClaudeTaskStatus\r\n  /** DSH turn during which this task was first observed, when known. */\r\n  originTurn?: number\r\n  subagentType?: string\r\n  taskType?: string\r\n  lastToolName?: string\r\n  summary?: string\r\n  usage?: ClaudeTaskUsage\r\n  /** True while the task runs detached (background command/subagent). */\r\n  backgrounded?: boolean\r\n}\r\n\r\n/** Level snapshot of one session's Claude task board, REPLACE semantics. */\r\nexport interface ClaudeTasksEvent {\r\n  tasks: readonly ClaudeTaskInfo[]\r\n}\r\n\r\nconst MAX_TASKS_PER_SNAPSHOT = 50\r\nconst MAX_TASK_TEXT_CHARS = 300\r\n\r\nconst TASK_STATUSES: ReadonlySet<string> = new Set(['running', 'completed', 'failed', 'stopped', 'killed'])\r\n\r\nfunction normalizeTaskUsage(input: ClaudeTaskUsage | undefined): ClaudeTaskUsage | undefined {\r\n  if (input === undefined) return undefined\r\n  const usage: ClaudeTaskUsage = {}\r\n  if (input.totalTokens !== undefined) usage.totalTokens = nonNegativeInteger(input.totalTokens)\r\n  if (input.toolUses !== undefined) usage.toolUses = nonNegativeInteger(input.toolUses)\r\n  if (input.durationMs !== undefined) usage.durationMs = nonNegativeInteger(input.durationMs)\r\n  return Object.keys(usage).length === 0 ? undefined : usage\r\n}\r\n\r\nexport function normalizeTasksEvent(tasks: readonly ClaudeTaskInfo[]): ClaudeTasksEvent {\r\n  return {\r\n    tasks: tasks.slice(0, MAX_TASKS_PER_SNAPSHOT).map(task => {\r\n      const usage = normalizeTaskUsage(task.usage)\r\n      return {\r\n        taskId: redactText(String(task.taskId), 128),\r\n        description: redactText(String(task.description), MAX_TASK_TEXT_CHARS),\r\n        status: TASK_STATUSES.has(task.status) ? task.status : 'running',\r\n        ...(task.originTurn === undefined ? {} : { originTurn: nonNegativeInteger(task.originTurn) }),\r\n        ...(task.subagentType === undefined ? {} : { subagentType: redactText(task.subagentType, 64) }),\r\n        ...(task.taskType === undefined ? {} : { taskType: redactText(task.taskType, 64) }),\r\n        ...(task.lastToolName === undefined ? {} : { lastToolName: redactText(task.lastToolName, 64) }),\r\n        ...(task.summary === undefined ? {} : { summary: redactText(task.summary, MAX_TASK_TEXT_CHARS) }),\r\n        ...(usage === undefined ? {} : { usage }),\r\n        ...(task.backgrounded === true ? { backgrounded: true } : {}),\r\n      }\r\n    }),\r\n  }\r\n}\r\n\r\nexport function latestClaudeTasks(\r\n  events: readonly SessionEvent[],\r\n): ClaudeTasksEvent | undefined {\r\n  for (let index = events.length - 1; index >= 0; index -= 1) {\r\n    const event = events[index]\r\n    if (event?.type === CLAUDE_TASKS_EVENT) return event.data as ClaudeTasksEvent\r\n  }\r\n  return undefined\r\n}\r\n\r\nexport type ClaudeActivityInput = Omit<\r\n  ClaudeActivityEvent,\r\n  'turn' | 'step' | 'ordinal' | 'summary' | 'detail'\r\n> & {\r\n  summary?: unknown\r\n  detail?: unknown\r\n}\r\n\r\nexport interface ClaudeActivityCursor {\r\n  turn: number\r\n  step: number\r\n  nextOrdinal: number\r\n}\r\n\r\n/** Derive the current DSH turn/step; activity ordinals are completed from the sidecar. */\r\nexport function currentClaudeActivityCursor(events: readonly SessionEvent[]): ClaudeActivityCursor {\r\n  let turn = 0\r\n  let step = 0\r\n  for (const event of events) {\r\n    if (event.type !== 'step/start') continue\r\n    const data = event.data as { turn: number; step: number }\r\n    turn = data.turn\r\n    step = data.step\r\n  }\r\n  if (turn < 1 || step < 1) {\r\n    throw new Error('dsh-claude: Claude activity requires an open DSH step')\r\n  }\r\n  return { turn, step, nextOrdinal: 0 }\r\n}\r\n\r\nexport function latestClaudeSessionBinding(\r\n  events: readonly SessionEvent[],\r\n): ClaudeSessionBoundEvent | undefined {\r\n  for (let index = events.length - 1; index >= 0; index -= 1) {\r\n    const event = events[index]\r\n    if (event?.type === CLAUDE_SESSION_BOUND_EVENT) {\r\n      return event.data as ClaudeSessionBoundEvent\r\n    }\r\n  }\r\n  return undefined\r\n}\r\n"],"mappings":"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"}
+{"version":3,"file":"events-DP0Ov_Re.mjs","names":[],"sources":["../src/constants.ts","../src/events.ts"],"sourcesContent":["export const CLAUDE_CODE_PROVIDER = 'claude'\r\nexport const CLAUDE_CODE_PRESET_ID = 'claude'\r\nexport const CLAUDE_CODE_PROVIDER_IDS = [CLAUDE_CODE_PROVIDER] as const\r\nexport const CLAUDE_SESSION_BOUND_EVENT = 'claude-code/session-bound'\r\nexport const CLAUDE_ACTIVITY_EVENT = 'claude-code/activity'\r\nexport const CLAUDE_CONTEXT_USAGE_EVENT = 'claude-code/context-usage'\r\nexport const CLAUDE_TASKS_EVENT = 'claude-code/tasks'\r\n/** Claude's subagent dispatch tools; rendered as plugin-owned group cards\r\n *  gathering subagent activity instead of native tool cards. */\r\nexport const TASK_TOOL_NAMES: ReadonlySet<string> = new Set(['Task', 'Agent'])\r\nexport const SDK_VERSION = '0.3.233'\r\nexport const CLAUDE_DOCTOR_PATH = '/plugins/dsh-claude/doctor'\r\nexport const CLAUDE_PROJECTION_PATH = '/plugins/dsh-claude/projection'\r\n","import type { SessionEvent } from '@deepseek-ai/dsh-session'\r\nimport {\r\n  CLAUDE_ACTIVITY_EVENT,\r\n  CLAUDE_CONTEXT_USAGE_EVENT,\r\n  CLAUDE_SESSION_BOUND_EVENT,\r\n  CLAUDE_TASKS_EVENT,\r\n} from './constants.ts'\r\n\r\nexport type ClaudeActivityKind =\r\n  | 'status'\r\n  | 'thinking'\r\n  | 'tool-call'\r\n  | 'tool-result'\r\n  | 'permission'\r\n  | 'question'\r\n  | 'subagent'\r\n  | 'usage'\r\n  | 'warning'\r\n  | 'error'\r\n\r\nexport type ClaudeActivityPhase =\r\n  | 'started'\r\n  | 'updated'\r\n  | 'completed'\r\n  | 'denied'\r\n  | 'failed'\r\n\r\nexport interface ClaudeUsage {\r\n  inputTokens?: number\r\n  outputTokens?: number\r\n  cacheReadTokens?: number\r\n  cacheCreationTokens?: number\r\n  cumulativeCostUsd?: number\r\n}\r\n\r\nexport interface ClaudeSessionBoundEvent {\r\n  claudeSessionId: string\r\n  cliVersion?: string\r\n  sdkVersion: string\r\n  cwd: string\r\n}\r\n\r\nexport interface ClaudeActivityEvent {\r\n  turn: number\r\n  step: number\r\n  ordinal: number\r\n  kind: ClaudeActivityKind\r\n  phase?: ClaudeActivityPhase\r\n  /** Claude task-board identity for lifecycle activity; never a transcript path. */\r\n  taskId?: string\r\n  toolUseId?: string\r\n  /** Enclosing Claude tool call for subagent-nested activity. */\r\n  parentToolUseId?: string\r\n  toolName?: string\r\n  title?: string\r\n  summary?: string\r\n  detail?: string\r\n  isError?: boolean\r\n  usage?: ClaudeUsage\r\n}\r\n\r\nexport interface ClaudeContextUsageCategory {\r\n  name: string\r\n  tokens: number\r\n  color: string\r\n  isDeferred?: boolean\r\n}\r\n\r\nexport interface ClaudeContextUsageEvent {\r\n  model: string\r\n  totalTokens: number\r\n  maxTokens: number\r\n  percentage: number\r\n  categories: readonly ClaudeContextUsageCategory[]\r\n}\r\n\r\nexport interface ClaudeContextUsageInput {\r\n  model: unknown\r\n  totalTokens: unknown\r\n  maxTokens: unknown\r\n  percentage: unknown\r\n  categories: readonly {\r\n    name?: unknown\r\n    tokens?: unknown\r\n    color?: unknown\r\n    isDeferred?: unknown\r\n  }[]\r\n}\r\n\r\ndeclare module '@deepseek-ai/dsh-session/types' {\r\n  interface SessionEventMap {\r\n    'claude-code/session-bound': ClaudeSessionBoundEvent\r\n    'claude-code/activity': ClaudeActivityEvent\r\n    'claude-code/context-usage': ClaudeContextUsageEvent\r\n    'claude-code/tasks': ClaudeTasksEvent\r\n  }\r\n}\r\n\r\nconst SECRET_KEY = /(?:^|[_-])(password|passwd|secret|token|api[_-]?key|authorization|credential|private[_-]?key|session[_-]?key|env|environ|environment)(?:$|[_-])/i\r\nconst MAX_SUMMARY_CHARS = 1_000\r\nconst MAX_DETAIL_CHARS = 4_000\r\nconst MAX_DEPTH = 6\r\nconst MAX_ARRAY_ITEMS = 40\r\nconst MAX_OBJECT_KEYS = 60\r\nconst REDACTED = '[REDACTED]'\r\nconst TRUNCATED = '…[truncated]'\r\nconst SECRET_ASSIGNMENT = /((?:password|passwd|secret|token|api[_-]?key|authorization|credential|private[_-]?key|session[_-]?key)\\s*(?:=|:)\\s*)(?:\"[^\"]*\"|'[^']*'|[^\\s,;&]+)/giu\r\nconst BEARER_TOKEN = /(\\bbearer\\s+)[A-Za-z0-9._~+/=-]+/giu\r\nconst PREFIXED_TOKEN = /\\b(?:sk-(?:ant-|proj-)?|xox[baprs]-|ghp_|github_pat_)[A-Za-z0-9_-]{8,}/giu\r\nconst JWT_TOKEN = /\\beyJ[A-Za-z0-9_-]+\\.[A-Za-z0-9_-]+\\.[A-Za-z0-9_-]+\\b/gu\r\nconst URL_USERINFO = /([a-z][a-z0-9+.-]*:\\/\\/[^:\\s/@]+:)[^@\\s/]+@/giu\r\nconst URL_SECRET_PARAM = /([?&](?:password|secret|token|api[_-]?key|access[_-]?token|refresh[_-]?token)=)[^&#\\s]+/giu\r\n\r\nexport function boundText(value: string, maxChars: number): string {\r\n  if (value.length <= maxChars) return value\r\n  return `${value.slice(0, Math.max(0, maxChars - TRUNCATED.length))}${TRUNCATED}`\r\n}\r\n\r\nexport function redactText(value: string, maxChars = MAX_DETAIL_CHARS): string {\r\n  return boundText(\r\n    value\r\n      .replace(JWT_TOKEN, REDACTED)\r\n      .replace(PREFIXED_TOKEN, REDACTED)\r\n      .replace(BEARER_TOKEN, `$1${REDACTED}`)\r\n      .replace(URL_USERINFO, `$1${REDACTED}@`)\r\n      .replace(URL_SECRET_PARAM, `$1${REDACTED}`)\r\n      .replace(SECRET_ASSIGNMENT, `$1${REDACTED}`),\r\n    maxChars,\r\n  )\r\n}\r\n\r\nexport function redactValue(value: unknown, depth = 0, seen = new WeakSet<object>()): unknown {\r\n  if (depth > MAX_DEPTH) return '[max-depth]'\r\n  if (value === null || typeof value === 'boolean' || typeof value === 'number') return value\r\n  if (typeof value === 'string') return redactText(value)\r\n  if (typeof value === 'bigint') return value.toString()\r\n  if (typeof value === 'undefined') return null\r\n  if (typeof value === 'function' || typeof value === 'symbol') return `[${typeof value}]`\r\n  if (value instanceof Error) {\r\n    return { name: value.name, message: redactText(value.message, MAX_SUMMARY_CHARS) }\r\n  }\r\n  if (typeof value !== 'object') return String(value)\r\n  if (seen.has(value)) return '[circular]'\r\n  seen.add(value)\r\n  try {\r\n    if (Array.isArray(value)) {\r\n      const items = value.slice(0, MAX_ARRAY_ITEMS).map(item => redactValue(item, depth + 1, seen))\r\n      if (value.length > MAX_ARRAY_ITEMS) items.push(`[${value.length - MAX_ARRAY_ITEMS} more items]`)\r\n      return items\r\n    }\r\n    const result: Record<string, unknown> = {}\r\n    const entries = Object.entries(value as Record<string, unknown>)\r\n    for (const [key, item] of entries.slice(0, MAX_OBJECT_KEYS)) {\r\n      result[key] = SECRET_KEY.test(key) ? REDACTED : redactValue(item, depth + 1, seen)\r\n    }\r\n    if (entries.length > MAX_OBJECT_KEYS) result.__truncatedKeys = entries.length - MAX_OBJECT_KEYS\r\n    return result\r\n  } finally {\r\n    seen.delete(value)\r\n  }\r\n}\r\n\r\nexport function safeDetail(value: unknown): string | undefined {\r\n  if (value === undefined) return undefined\r\n  const redacted = redactValue(value)\r\n  const text = typeof redacted === 'string' ? redacted : JSON.stringify(redacted)\r\n  return boundText(text, MAX_DETAIL_CHARS)\r\n}\r\n\r\nexport function normalizeActivity(\r\n  activity: Omit<ClaudeActivityEvent, 'summary' | 'detail'> & {\r\n    summary?: unknown\r\n    detail?: unknown\r\n  },\r\n): ClaudeActivityEvent {\r\n  const normalized: ClaudeActivityEvent = {\r\n    turn: activity.turn,\r\n    step: activity.step,\r\n    ordinal: activity.ordinal,\r\n    kind: activity.kind,\r\n  }\r\n  if (activity.phase !== undefined) normalized.phase = activity.phase\r\n  if (activity.taskId !== undefined) normalized.taskId = redactText(activity.taskId, 128)\r\n  if (activity.toolUseId !== undefined) normalized.toolUseId = redactText(activity.toolUseId, 256)\r\n  if (activity.parentToolUseId !== undefined) normalized.parentToolUseId = redactText(activity.parentToolUseId, 256)\r\n  if (activity.toolName !== undefined) normalized.toolName = redactText(activity.toolName, 256)\r\n  if (activity.title !== undefined) normalized.title = redactText(activity.title, MAX_SUMMARY_CHARS)\r\n  if (activity.summary !== undefined) {\r\n    normalized.summary = redactText(\r\n      typeof activity.summary === 'string' ? activity.summary : safeDetail(activity.summary) ?? '',\r\n      MAX_SUMMARY_CHARS,\r\n    )\r\n  }\r\n  const detail = safeDetail(activity.detail)\r\n  if (detail !== undefined) normalized.detail = detail\r\n  if (activity.isError !== undefined) normalized.isError = activity.isError\r\n  if (activity.usage !== undefined) normalized.usage = { ...activity.usage }\r\n  return normalized\r\n}\r\n\r\nconst MAX_CONTEXT_CATEGORIES = 24\r\nconst FALLBACK_CONTEXT_COLOR = '#8b95a5'\r\nconst SAFE_CONTEXT_COLOR = /^#[0-9a-f]{3,8}$/iu\r\n\r\nfunction nonNegativeInteger(value: unknown): number {\r\n  return typeof value === 'number' && Number.isFinite(value)\r\n    ? Math.max(0, Math.floor(value))\r\n    : 0\r\n}\r\n\r\nexport function normalizeContextUsage(input: ClaudeContextUsageInput): ClaudeContextUsageEvent {\r\n  return {\r\n    model: redactText(typeof input.model === 'string' ? input.model : 'unknown', 128),\r\n    totalTokens: nonNegativeInteger(input.totalTokens),\r\n    maxTokens: nonNegativeInteger(input.maxTokens),\r\n    percentage: Math.min(100, nonNegativeInteger(input.percentage)),\r\n    categories: input.categories.slice(0, MAX_CONTEXT_CATEGORIES).map(category => ({\r\n      name: redactText(typeof category.name === 'string' ? category.name : 'Unknown', 128),\r\n      tokens: nonNegativeInteger(category.tokens),\r\n      color: typeof category.color === 'string' && SAFE_CONTEXT_COLOR.test(category.color)\r\n        ? category.color\r\n        : FALLBACK_CONTEXT_COLOR,\r\n      ...(category.isDeferred === true ? { isDeferred: true } : {}),\r\n    })),\r\n  }\r\n}\r\n\r\nexport function latestClaudeContextUsage(\r\n  events: readonly SessionEvent[],\r\n): ClaudeContextUsageEvent | undefined {\r\n  for (let index = events.length - 1; index >= 0; index -= 1) {\r\n    const event = events[index]\r\n    if (event?.type === CLAUDE_CONTEXT_USAGE_EVENT) return event.data as ClaudeContextUsageEvent\r\n  }\r\n  return undefined\r\n}\r\n\r\nexport type ClaudeTaskStatus = 'running' | 'completed' | 'failed' | 'stopped' | 'killed'\r\n\r\nexport interface ClaudeTaskUsage {\r\n  totalTokens?: number\r\n  toolUses?: number\r\n  durationMs?: number\r\n}\r\n\r\nexport interface ClaudeTaskInfo {\r\n  taskId: string\r\n  description: string\r\n  status: ClaudeTaskStatus\r\n  /** DSH turn during which this task was first observed, when known. */\r\n  originTurn?: number\r\n  subagentType?: string\r\n  taskType?: string\r\n  lastToolName?: string\r\n  summary?: string\r\n  usage?: ClaudeTaskUsage\r\n  /** True while the task runs detached (background command/subagent). */\r\n  backgrounded?: boolean\r\n}\r\n\r\n/** Level snapshot of one session's Claude task board, REPLACE semantics. */\r\nexport interface ClaudeTasksEvent {\r\n  tasks: readonly ClaudeTaskInfo[]\r\n}\r\n\r\nconst MAX_TASKS_PER_SNAPSHOT = 50\r\nconst MAX_TASK_TEXT_CHARS = 300\r\n\r\nconst TASK_STATUSES: ReadonlySet<string> = new Set(['running', 'completed', 'failed', 'stopped', 'killed'])\r\n\r\nfunction normalizeTaskUsage(input: ClaudeTaskUsage | undefined): ClaudeTaskUsage | undefined {\r\n  if (input === undefined) return undefined\r\n  const usage: ClaudeTaskUsage = {}\r\n  if (input.totalTokens !== undefined) usage.totalTokens = nonNegativeInteger(input.totalTokens)\r\n  if (input.toolUses !== undefined) usage.toolUses = nonNegativeInteger(input.toolUses)\r\n  if (input.durationMs !== undefined) usage.durationMs = nonNegativeInteger(input.durationMs)\r\n  return Object.keys(usage).length === 0 ? undefined : usage\r\n}\r\n\r\nexport function normalizeTasksEvent(tasks: readonly ClaudeTaskInfo[]): ClaudeTasksEvent {\r\n  return {\r\n    tasks: tasks.slice(0, MAX_TASKS_PER_SNAPSHOT).map(task => {\r\n      const usage = normalizeTaskUsage(task.usage)\r\n      return {\r\n        taskId: redactText(String(task.taskId), 128),\r\n        description: redactText(String(task.description), MAX_TASK_TEXT_CHARS),\r\n        status: TASK_STATUSES.has(task.status) ? task.status : 'running',\r\n        ...(task.originTurn === undefined ? {} : { originTurn: nonNegativeInteger(task.originTurn) }),\r\n        ...(task.subagentType === undefined ? {} : { subagentType: redactText(task.subagentType, 64) }),\r\n        ...(task.taskType === undefined ? {} : { taskType: redactText(task.taskType, 64) }),\r\n        ...(task.lastToolName === undefined ? {} : { lastToolName: redactText(task.lastToolName, 64) }),\r\n        ...(task.summary === undefined ? {} : { summary: redactText(task.summary, MAX_TASK_TEXT_CHARS) }),\r\n        ...(usage === undefined ? {} : { usage }),\r\n        ...(task.backgrounded === true ? { backgrounded: true } : {}),\r\n      }\r\n    }),\r\n  }\r\n}\r\n\r\nexport function latestClaudeTasks(\r\n  events: readonly SessionEvent[],\r\n): ClaudeTasksEvent | undefined {\r\n  for (let index = events.length - 1; index >= 0; index -= 1) {\r\n    const event = events[index]\r\n    if (event?.type === CLAUDE_TASKS_EVENT) return event.data as ClaudeTasksEvent\r\n  }\r\n  return undefined\r\n}\r\n\r\nexport type ClaudeActivityInput = Omit<\r\n  ClaudeActivityEvent,\r\n  'turn' | 'step' | 'ordinal' | 'summary' | 'detail'\r\n> & {\r\n  summary?: unknown\r\n  detail?: unknown\r\n}\r\n\r\nexport interface ClaudeActivityCursor {\r\n  turn: number\r\n  step: number\r\n  nextOrdinal: number\r\n}\r\n\r\n/** Derive the current DSH turn/step; activity ordinals are completed from the sidecar. */\r\nexport function currentClaudeActivityCursor(events: readonly SessionEvent[]): ClaudeActivityCursor {\r\n  let turn = 0\r\n  let step = 0\r\n  for (const event of events) {\r\n    if (event.type !== 'step/start') continue\r\n    const data = event.data as { turn: number; step: number }\r\n    turn = data.turn\r\n    step = data.step\r\n  }\r\n  if (turn < 1 || step < 1) {\r\n    throw new Error('dsh-claude: Claude activity requires an open DSH step')\r\n  }\r\n  return { turn, step, nextOrdinal: 0 }\r\n}\r\n\r\nexport function latestClaudeSessionBinding(\r\n  events: readonly SessionEvent[],\r\n): ClaudeSessionBoundEvent | undefined {\r\n  for (let index = events.length - 1; index >= 0; index -= 1) {\r\n    const event = events[index]\r\n    if (event?.type === CLAUDE_SESSION_BOUND_EVENT) {\r\n      return event.data as ClaudeSessionBoundEvent\r\n    }\r\n  }\r\n  return undefined\r\n}\r\n"],"mappings":"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"}

package/lib/index.d.mts

@@ -6,6 +6,7 @@ import { Agent } from "@deepseek-ai/dsh-agent";
 import { CommandDefinition, CommandDescriptor } from "@deepseek-ai/dsh-commands";
 import { SessionEvent } from "@deepseek-ai/dsh-session";
 import { ApprovalService } from "@deepseek-ai/dsh-user-approval";
+import { UserQuestionService } from "@deepseek-ai/dsh-user-questions";
 //#region src/command-bridge.d.ts
 /**
  * Agent-scope command service contract. The commands service is unreachable
@@ -26,7 +27,7 @@ declare module '@deepseek-ai/cordis' {
 }
 //#endregion
 //#region src/events.d.ts
-type ClaudeActivityKind = 'status' | 'thinking' | 'tool-call' | 'tool-result' | 'permission' | 'subagent' | 'usage' | 'warning' | 'error';
+type ClaudeActivityKind = 'status' | 'thinking' | 'tool-call' | 'tool-result' | 'permission' | 'question' | 'subagent' | 'usage' | 'warning' | 'error';
 type ClaudeActivityPhase = 'started' | 'updated' | 'completed' | 'denied' | 'failed';
 interface ClaudeUsage {
   inputTokens?: number;
@@ -199,6 +200,7 @@ declare class ClaudeSupervisor {
   constructor(dependencies: {
     runtime: Pick<SubprocessRuntime, 'spawn'>;
     approval: Pick<ApprovalService, 'request'>;
+    userQuestions: Pick<UserQuestionService, 'ask'>;
     config: ClaudeSupervisorConfig;
     queryFactory?: ClaudeQueryFactory;
     runDetached?: <T>(operation: () => T) => T;

package/lib/index.mjs

@@ -45,6 +45,7 @@ const ACTIVITY_KINDS = /* @__PURE__ */ new Set([
 	"tool-call",
 	"tool-result",
 	"permission",
+	"question",
 	"subagent",
 	"usage",
 	"warning",
@@ -336,8 +337,14 @@ function mapApprovalOutcome(outcome, input, toolUseID) {
 		decisionClassification: "user_reject"
 	};
 }
-function createPermissionBridge(approval, activeContext) {
+function createPermissionBridge(approval, activeContext, userQuestion) {
 	return async (toolName, input, options) => {
+		if (toolName === "AskUserQuestion") return userQuestion === void 0 ? {
+			behavior: "deny",
+			message: "DeepSeek Harness user questions are unavailable; the question was cancelled.",
+			toolUseID: options.toolUseID,
+			decisionClassification: "user_reject"
+		} : userQuestion(input, options);
 		const active = activeContext();
 		if (active === void 0) return {
 			behavior: "deny",
@@ -401,6 +408,120 @@ function createPermissionBridge(approval, activeContext) {
 	};
 }
 //#endregion
+//#region src/user-question.ts
+const FAILURE_MESSAGE = "DeepSeek Harness could not collect an answer; the question was cancelled.";
+const INVALID_MESSAGE = "Claude Code sent an invalid user-question request; the question was cancelled.";
+function failureMessage(error) {
+	const code = error !== null && typeof error === "object" && "code" in error ? error.code : void 0;
+	return typeof code === "string" && /^[A-Z][A-Z0-9_]*$/.test(code) ? `${FAILURE_MESSAGE} (${code})` : FAILURE_MESSAGE;
+}
+function deny(message, toolUseID) {
+	return {
+		behavior: "deny",
+		message,
+		toolUseID,
+		decisionClassification: "user_reject"
+	};
+}
+function optionalText(value) {
+	return typeof value === "string" && value.length > 0 ? value : void 0;
+}
+function parseQuestions(input, toolUseID) {
+	if (!Array.isArray(input.questions) || input.questions.length === 0 || input.questions.length > 20) return void 0;
+	const seen = /* @__PURE__ */ new Set();
+	const questions = [];
+	for (const [index, value] of input.questions.entries()) {
+		if (value === null || typeof value !== "object" || Array.isArray(value)) return void 0;
+		const item = value;
+		if (typeof item.question !== "string" || item.question.length === 0 || seen.has(item.question)) return void 0;
+		seen.add(item.question);
+		if (item.options !== void 0 && !Array.isArray(item.options)) return void 0;
+		const options = (item.options ?? []).map((option) => {
+			if (option === null || typeof option !== "object" || Array.isArray(option)) return void 0;
+			const record = option;
+			if (typeof record.label !== "string" || record.label.length === 0) return void 0;
+			const description = optionalText(record.description);
+			return {
+				label: record.label,
+				...description === void 0 ? {} : { description }
+			};
+		});
+		if (options.some((option) => option === void 0)) return void 0;
+		const header = optionalText(item.header);
+		questions.push({
+			id: `${toolUseID}:${index}`,
+			question: item.question,
+			...header === void 0 ? {} : { header },
+			options,
+			multiSelect: item.multiSelect === true
+		});
+	}
+	return questions;
+}
+function answerText(answer, multiSelect) {
+	if (answer === void 0) return "";
+	const custom = optionalText(answer.custom);
+	if (!multiSelect && custom !== void 0) return custom;
+	return [...answer.selected, ...custom === void 0 ? [] : [custom]].join(", ");
+}
+function createUserQuestionBridge(userQuestions, activeContext) {
+	return async (input, options) => {
+		const active = activeContext();
+		if (active === void 0) return deny("No active DeepSeek Harness turn owns this Claude Code question.", options.toolUseID);
+		const questions = parseQuestions(input, options.toolUseID);
+		if (questions === void 0) return deny(INVALID_MESSAGE, options.toolUseID);
+		active.markActivity?.();
+		try {
+			await active.appendActivity({
+				kind: "question",
+				phase: "started",
+				toolUseId: options.toolUseID,
+				toolName: "AskUserQuestion",
+				title: "Claude asked a question",
+				summary: questions.length === 1 ? questions[0].question : `Claude asked ${questions.length} questions`
+			});
+			const response = await userQuestions.ask({
+				questions,
+				agent: active.agent,
+				signal: options.signal
+			});
+			const answersById = new Map(response.answers.map((answer) => [answer.id, answer]));
+			const answers = Object.fromEntries(questions.map((question) => [question.question, answerText(answersById.get(question.id), question.multiSelect === true)]));
+			await active.appendActivity({
+				kind: "question",
+				phase: "completed",
+				toolUseId: options.toolUseID,
+				toolName: "AskUserQuestion",
+				title: "Claude asked a question",
+				summary: "Answered in DeepSeek Harness"
+			});
+			return {
+				behavior: "allow",
+				updatedInput: {
+					...input,
+					answers
+				},
+				toolUseID: options.toolUseID,
+				decisionClassification: "user_temporary"
+			};
+		} catch (error) {
+			const message = failureMessage(error);
+			try {
+				await active.appendActivity({
+					kind: "question",
+					phase: "failed",
+					toolUseId: options.toolUseID,
+					toolName: "AskUserQuestion",
+					title: "Claude asked a question",
+					summary: message,
+					isError: true
+				});
+			} catch {}
+			return deny(message, options.toolUseID);
+		}
+	};
+}
+//#endregion
 //#region src/sdk-messages.ts
 function record(value) {
 	return value !== null && typeof value === "object" ? value : void 0;
@@ -908,6 +1029,7 @@ var ClaudeSupervisor = class {
 	#entries = /* @__PURE__ */ new Map();
 	#runtime;
 	#approval;
+	#userQuestions;
 	#config;
 	#queryFactory;
 	#runDetached;
@@ -919,6 +1041,7 @@ var ClaudeSupervisor = class {
 	constructor(dependencies) {
 		this.#runtime = dependencies.runtime;
 		this.#approval = dependencies.approval;
+		this.#userQuestions = dependencies.userQuestions;
 		this.#config = dependencies.config;
 		this.#queryFactory = dependencies.queryFactory ?? ((params) => query(params));
 		this.#runDetached = dependencies.runDetached ?? ((operation) => operation());
@@ -1154,7 +1277,7 @@ var ClaudeSupervisor = class {
 			taskSnapshotAt: 0,
 			taskSnapshotTimer: void 0
 		};
-		const canUseTool = createPermissionBridge(this.#approval, () => {
+		const activeInteraction = () => {
 			const active = entry.active;
 			return active === void 0 ? void 0 : {
 				agent: active.agent,
@@ -1171,7 +1294,9 @@ var ClaudeSupervisor = class {
 				},
 				appendActivity: (activity) => this.#appendActivity(active, activity)
 			};
-		});
+		};
+		const userQuestion = createUserQuestionBridge(this.#userQuestions, activeInteraction);
+		const canUseTool = createPermissionBridge(this.#approval, activeInteraction, userQuestion);
 		const options = {
 			pathToClaudeCodeExecutable: this.#config.executablePath,
 			cwd,
@@ -2081,7 +2206,8 @@ const inject = [
 	"agentPresets",
 	"commands",
 	"subprocess",
-	"approval"
+	"approval",
+	"userQuestions"
 ];
 const Config = z.object({
 	executablePath: z.string().default(""),
@@ -2213,6 +2339,7 @@ async function apply(ctx, config) {
 	const supervisor = new ClaudeSupervisor({
 		runtime: ctx.subprocess,
 		approval: ctx.approval,
+		userQuestions: ctx.userQuestions,
 		config: supervisorConfig,
 		runDetached: (operation) => ctx.agents.withoutInitiator(operation),
 		sidecar