@norman-else/dsh-claude 0.1.33 → 0.1.35

package/lib/{events-DeSV0S1-.mjs → events-Doid-tq7.mjs}

@@ -24,6 +24,11 @@ const CLAUDE_JIRA_PATH = "/plugins/dsh-claude/jira";
 const CLAUDE_ASK_PATH = "/plugins/dsh-claude/ask";
 const CLAUDE_EDITOR_OPEN_PATH = "/plugins/dsh-claude/editor/open";
 const CLAUDE_REWIND_PATH = "/plugins/dsh-claude/rewind";
+const CLAUDE_RENDER_MODES = ["plugin", "native"];
+const DEFAULT_CLAUDE_RENDER_MODE = "plugin";
+function isClaudeRenderMode(value) {
+	return value === "plugin" || value === "native";
+}
 //#endregion
 //#region src/events.ts
 const SECRET_KEY = /(?:^|[_-])(password|passwd|secret|token|api[_-]?key|authorization|credential|private[_-]?key|session[_-]?key|env|environ|environment)(?:$|[_-])/i;
@@ -101,6 +106,7 @@ function normalizeActivity(activity) {
 	if (activity.text !== void 0) normalized.text = redactText(activity.text, MAX_TRANSCRIPT_TEXT_CHARS);
 	if (activity.isError !== void 0) normalized.isError = activity.isError;
 	if (activity.usage !== void 0) normalized.usage = { ...activity.usage };
+	if (isClaudeRenderMode(activity.renderer)) normalized.renderer = activity.renderer;
 	return normalized;
 }
 const MAX_CONTEXT_CATEGORIES = 24;
@@ -193,6 +199,6 @@ function latestClaudeSessionBinding(events) {
 	}
 }
 //#endregion
-export { CLAUDE_UPDATE_PATH as A, CLAUDE_REPOSITORY_FEEDBACK_PATH as C, CLAUDE_REVIEW_COMMENT_PATH as D, CLAUDE_REPOSITORY_STATUS_PATH as E, SDK_VERSION as M, TASK_TOOL_NAMES as N, CLAUDE_REWIND_PATH as O, CLAUDE_REPOSITORY_ACTION_PATH as S, CLAUDE_REPOSITORY_SETUP_PATH as T, CLAUDE_DOCTOR_PATH as _, latestClaudeTasks as a, CLAUDE_JIRA_PATH as b, normalizeTasksEvent as c, CLAUDE_ACTIVITY_EVENT as d, CLAUDE_ASK_PATH as f, CLAUDE_CODE_PROVIDER_IDS as g, CLAUDE_CODE_PROVIDER as h, latestClaudeSessionBinding as i, CLAUDE_USAGE_PATH as j, CLAUDE_UPDATE_CHECK_PATH as k, redactText as l, CLAUDE_CODE_PRESET_ID as m, currentClaudeActivityCursor as n, normalizeActivity as o, CLAUDE_CLIENT_DIAGNOSTICS_PATH as p, latestClaudeContextUsage as r, normalizeContextUsage as s, boundText as t, safeDetail as u, CLAUDE_EDITOR_OPEN_PATH as v, CLAUDE_REPOSITORY_FILE_PATH as w, CLAUDE_PROJECTION_PATH as x, CLAUDE_GLOBAL_SETTINGS_PATH as y };
+export { CLAUDE_UPDATE_CHECK_PATH as A, CLAUDE_REPOSITORY_ACTION_PATH as C, CLAUDE_REPOSITORY_STATUS_PATH as D, CLAUDE_REPOSITORY_SETUP_PATH as E, TASK_TOOL_NAMES as F, isClaudeRenderMode as I, CLAUDE_USAGE_PATH as M, DEFAULT_CLAUDE_RENDER_MODE as N, CLAUDE_REVIEW_COMMENT_PATH as O, SDK_VERSION as P, CLAUDE_RENDER_MODES as S, CLAUDE_REPOSITORY_FILE_PATH as T, CLAUDE_DOCTOR_PATH as _, latestClaudeTasks as a, CLAUDE_JIRA_PATH as b, normalizeTasksEvent as c, CLAUDE_ACTIVITY_EVENT as d, CLAUDE_ASK_PATH as f, CLAUDE_CODE_PROVIDER_IDS as g, CLAUDE_CODE_PROVIDER as h, latestClaudeSessionBinding as i, CLAUDE_UPDATE_PATH as j, CLAUDE_REWIND_PATH as k, redactText as l, CLAUDE_CODE_PRESET_ID as m, currentClaudeActivityCursor as n, normalizeActivity as o, CLAUDE_CLIENT_DIAGNOSTICS_PATH as p, latestClaudeContextUsage as r, normalizeContextUsage as s, boundText as t, safeDetail as u, CLAUDE_EDITOR_OPEN_PATH as v, CLAUDE_REPOSITORY_FEEDBACK_PATH as w, CLAUDE_PROJECTION_PATH as x, CLAUDE_GLOBAL_SETTINGS_PATH as y };
 
-//# sourceMappingURL=events-DeSV0S1-.mjs.map
+//# sourceMappingURL=events-Doid-tq7.mjs.map

package/lib/events-Doid-tq7.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"events-Doid-tq7.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.247'\r\nexport const CLAUDE_DOCTOR_PATH = '/plugins/dsh-claude/doctor'\r\nexport const CLAUDE_CLIENT_DIAGNOSTICS_PATH = '/plugins/dsh-claude/client-diagnostics'\r\nexport const CLAUDE_UPDATE_CHECK_PATH = '/plugins/dsh-claude/update/check'\r\nexport const CLAUDE_USAGE_PATH = '/plugins/dsh-claude/usage'\r\nexport const CLAUDE_UPDATE_PATH = '/plugins/dsh-claude/update'\r\nexport const CLAUDE_PROJECTION_PATH = '/plugins/dsh-claude/projection'\r\nexport const CLAUDE_GLOBAL_SETTINGS_PATH = '/plugins/dsh-claude/settings/global'\r\nexport const CLAUDE_REPOSITORY_SETUP_PATH = '/plugins/dsh-claude/repository/setup'\r\nexport const CLAUDE_REPOSITORY_ACTION_PATH = '/plugins/dsh-claude/repository/action'\r\nexport const CLAUDE_REVIEW_COMMENT_PATH = '/plugins/dsh-claude/review-comments'\r\nexport const CLAUDE_REPOSITORY_FEEDBACK_PATH = '/plugins/dsh-claude/repository/feedback'\r\nexport const CLAUDE_REPOSITORY_STATUS_PATH = '/plugins/dsh-claude/repository/status'\r\nexport const CLAUDE_REPOSITORY_FILE_PATH = '/plugins/dsh-claude/repository/file'\r\nexport const CLAUDE_JIRA_PATH = '/plugins/dsh-claude/jira'\r\nexport const CLAUDE_ASK_PATH = '/plugins/dsh-claude/ask'\r\nexport const CLAUDE_EDITOR_OPEN_PATH = '/plugins/dsh-claude/editor/open'\r\nexport const CLAUDE_REWIND_PATH = '/plugins/dsh-claude/rewind'\r\n\r\n/** Which renderer draws Claude's visible output.\r\n *\r\n *  'plugin' keeps the sidecar-backed transcript this package owns (interleaved\r\n *  prose, grouped tool cards, activity rows). 'native' hands the same turn to\r\n *  DSH's own conversation renderer: prose streams as ordinary assistant text\r\n *  blocks, thinking as reasoning blocks, and root Claude tools are mirrored\r\n *  into the durable `tool/call`/`tool/result` channel so the Host's tool\r\n *  presentation pipeline draws them exactly like DSH-executed calls. */\r\nexport type ClaudeRenderMode = 'plugin' | 'native'\r\nexport const CLAUDE_RENDER_MODES = ['plugin', 'native'] as const\r\nexport const DEFAULT_CLAUDE_RENDER_MODE: ClaudeRenderMode = 'plugin'\r\n\r\nexport function isClaudeRenderMode(value: unknown): value is ClaudeRenderMode {\r\n  return value === 'plugin' || value === 'native'\r\n}\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  isClaudeRenderMode,\r\n  type ClaudeRenderMode,\r\n} from './constants.ts'\r\n\r\nexport type ClaudeActivityKind =\r\n  | 'text'\r\n  | 'status'\r\n  /** Context compaction boundary; the transcript draws it as a divider. */\r\n  | 'compaction'\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  /** Redacted visible Claude prose used by the plugin-owned interleaved transcript. */\r\n  text?: string\r\n  isError?: boolean\r\n  usage?: ClaudeUsage\r\n  /** Which renderer this record was produced for. Stamped only when the Host\r\n   *  drew the step natively, so a record written before the setting existed —\r\n   *  and every record written under the plugin renderer — reads as 'plugin'.\r\n   *  It travels with the data so a step always renders the way it was\r\n   *  recorded, whatever the setting says now. */\r\n  renderer?: ClaudeRenderMode\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_TRANSCRIPT_TEXT_CHARS = 64_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.text !== undefined) normalized.text = redactText(activity.text, MAX_TRANSCRIPT_TEXT_CHARS)\r\n  if (activity.isError !== undefined) normalized.isError = activity.isError\r\n  if (activity.usage !== undefined) normalized.usage = { ...activity.usage }\r\n  if (isClaudeRenderMode(activity.renderer)) normalized.renderer = activity.renderer\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

@@ -31,6 +31,17 @@ interface ClaudeCommandView {
   prefixed: boolean;
 }
 //#endregion
+//#region src/constants.d.ts
+/** Which renderer draws Claude's visible output.
+ *
+ *  'plugin' keeps the sidecar-backed transcript this package owns (interleaved
+ *  prose, grouped tool cards, activity rows). 'native' hands the same turn to
+ *  DSH's own conversation renderer: prose streams as ordinary assistant text
+ *  blocks, thinking as reasoning blocks, and root Claude tools are mirrored
+ *  into the durable `tool/call`/`tool/result` channel so the Host's tool
+ *  presentation pipeline draws them exactly like DSH-executed calls. */
+type ClaudeRenderMode = 'plugin' | 'native';
+//#endregion
 //#region src/events.d.ts
 type ClaudeActivityKind = 'text' | 'status' |
 /** Context compaction boundary; the transcript draws it as a divider. */
@@ -68,6 +79,12 @@ interface ClaudeActivityEvent {
   text?: string;
   isError?: boolean;
   usage?: ClaudeUsage;
+  /** Which renderer this record was produced for. Stamped only when the Host
+   *  drew the step natively, so a record written before the setting existed —
+   *  and every record written under the plugin renderer — reads as 'plugin'.
+   *  It travels with the data so a step always renders the way it was
+   *  recorded, whatever the setting says now. */
+  renderer?: ClaudeRenderMode;
 }
 interface ClaudeContextUsageCategory {
   name: string;
@@ -168,7 +185,10 @@ interface ClaudeSidecarProjection {
   readonly tasks?: ClaudeTasksEvent;
   readonly rewind?: ClaudeRewindState;
 }
-/** Change notification published to live subscribers after each accepted write. */
+/** Change notification published to live subscribers after each accepted write.
+ *
+ *  `checkpoint` is the one kind that carries no change: it restates where the
+ *  stream stands so a reader can notice it is behind. See {@link ClaudeSidecarRepository.checkpoint}. */
 type ClaudeSidecarDelta = {
   kind: 'text';
   turn: number;
@@ -176,6 +196,7 @@ type ClaudeSidecarDelta = {
   ordinal: number;
   append?: string;
   text?: string;
+  renderer?: ClaudeRenderMode;
 } | {
   kind: 'activity';
   activity: ClaudeActivityEvent;
@@ -187,6 +208,18 @@ type ClaudeSidecarDelta = {
   value: ClaudeTasksEvent;
 } | {
   kind: 'sync';
+} | {
+  kind: 'checkpoint';
+};
+/** One delta as subscribers see it: numbered, so a reader that applies them in
+ *  order can tell a missing one from a slow one.
+ *
+ *  The projection's own `revision` cannot do this job. Streaming prose notifies
+ *  subscribers without touching disk (see {@link ClaudeSidecarRepository.appendTranscriptText}),
+ *  so revisions and notifications advance on different clocks; this counter
+ *  advances once per notification and nothing else reads it. */
+type ClaudeSidecarNotification = ClaudeSidecarDelta & {
+  readonly seq: number;
 };
 interface ClaudeSidecarRepositoryOptions {
   readonly root?: string;
@@ -199,7 +232,7 @@ declare class ClaudeSidecarRepository {
   constructor(options?: ClaudeSidecarRepositoryOptions);
   read(sessionId: string): Promise<ClaudeSidecarProjection>;
   /** Observe accepted changes for one session; returns the unsubscriber. */
-  subscribe(sessionId: string, listener: (delta: ClaudeSidecarDelta) => void): () => void;
+  subscribe(sessionId: string, listener: (delta: ClaudeSidecarNotification) => void): () => void;
   /** Record streaming assistant prose without touching the disk on the hot
    *  path: subscribers are notified synchronously (as an append when the
    *  redacted text grows in place) and persistence is coalesced. */
@@ -208,9 +241,19 @@ declare class ClaudeSidecarRepository {
     step: number;
     ordinal: number;
     text: string;
+    renderer?: ClaudeRenderMode;
   }): void;
   /** Persist any pending streaming transcript now (segment close, turn end). */
   flushTranscriptText(sessionId: string): Promise<void>;
+  /** How many notifications this session has published. */
+  sequence(sessionId: string): number;
+  /** Restate where the stream stands without changing anything.
+   *
+   *  A reader detects a lost delta from the hole the NEXT one leaves, which
+   *  never comes when the lost delta was the last of a turn -- exactly the
+   *  case that leaves a finished tool group pulsing forever. Called at turn
+   *  settlement, this gives that reader the one line it needs to disagree. */
+  checkpoint(sessionId: string): void;
   writeBinding(sessionId: string, value: Omit<ClaudeSessionBoundEvent, 'sdkVersion'> & {
     sdkVersion?: string;
   }): Promise<ClaudeSidecarProjection>;
@@ -239,10 +282,19 @@ interface ClaudeSupervisorConfig {
   idleTimeoutMs: number;
   maxProcesses: number;
   defaultModel: string;
+  /** Which renderer the visible turn is produced for; read per message so a
+   *  Settings change lands on the next turn without a Host restart. */
+  renderMode?: ClaudeRenderMode;
 }
 type ClaudeTurnStreamEvent = {
   type: 'text-delta';
   text: string;
+} |
+/** One settled Claude thinking block, forwarded only for the native
+ *  renderer, which draws it as a DSH reasoning block. */
+{
+  type: 'thinking';
+  text: string;
 } | {
   type: 'usage';
   usage: ClaudeUsage;