@goodandready/dsh-kanban 0.2.32 → 0.2.33

package/lib/client.js

@@ -1266,6 +1266,29 @@ window.__ModuleLoader__.load({
       'error.crossSite': 'Request rejected as cross-site.',
       'error.timeout': 'Request timed out. Please try again.',
       'error.unknown': 'Request failed.',
+      'field.costMeterEnabled': 'Cost Meter Telemetry',
+      'hint.costMeterEnabled': 'Enable token and cost telemetry integration via @goodandready/dsh-cost-meter.',
+      'field.taskCostLimit': 'Task Cost Limit (USD)',
+      'hint.taskCostLimit': 'Cost threshold per task in USD; 0 disables threshold warnings.',
+      'card.costLimitExceeded': 'Cost limit exceeded',
+      'card.nudge': 'Nudge',
+      'card.nudgeHint': 'Send live instruction to running agent',
+      'nudge.title': 'Live Steering',
+      'nudge.placeholder': 'Enter immediate instruction or correction for the agent...',
+      'nudge.send': 'Send',
+      'nudge.sending': 'Sending...',
+      'nudge.success': 'Instruction delivered to agent',
+      'nudge.failed': 'Failed to deliver instruction',
+      'costMeter.notice': 'Cost and token tracking requires @goodandready/dsh-cost-meter to be installed and active in DSH profile.',
+      'costMeter.active': 'Plugin @goodandready/dsh-cost-meter is active',
+      'costMeter.inactive': 'Plugin @goodandready/dsh-cost-meter not detected',
+      'telemetry.title': 'Resource Telemetry',
+      'telemetry.tokens': 'Tokens',
+      'telemetry.input': 'Input',
+      'telemetry.output': 'Output',
+      'telemetry.cache': 'Cached',
+      'telemetry.cost': 'Estimated Cost',
+      'telemetry.limit': 'Budget Limit',
     }
 
     const zh = {
@@ -1667,6 +1690,29 @@ window.__ModuleLoader__.load({
       'error.crossSite': '请求被判定为跨站而拒绝。',
       'error.timeout': '请求超时，请重试。',
       'error.unknown': '请求失败。',
+      'field.costMeterEnabled': '成本计量遥测',
+      'hint.costMeterEnabled': '通过 @goodandready/dsh-cost-meter 启用 Token 和成本遥测集成。',
+      'field.taskCostLimit': '任务成本限额 (USD)',
+      'hint.taskCostLimit': '每个任务的成本阈值（美元）；0 表示禁用超额警告。',
+      'card.costLimitExceeded': '超出成本限额',
+      'card.nudge': '引导',
+      'card.nudgeHint': '向正在运行的 Agent 发送实时引导指令',
+      'nudge.title': '实时引导',
+      'nudge.placeholder': '输入对 Agent 的即时指令或修正建议...',
+      'nudge.send': '发送',
+      'nudge.sending': '正在发送...',
+      'nudge.success': '指令已发送给 Agent',
+      'nudge.failed': '发送指令失败',
+      'costMeter.notice': 'Token 及成本追踪功能需要 DSH Profile 中安装并激活 @goodandready/dsh-cost-meter 插件。',
+      'costMeter.active': '已激活 @goodandready/dsh-cost-meter 插件',
+      'costMeter.inactive': '未检测到 @goodandready/dsh-cost-meter 插件',
+      'telemetry.title': '资源遥测',
+      'telemetry.tokens': 'Token 统计',
+      'telemetry.input': '输入',
+      'telemetry.output': '输出',
+      'telemetry.cache': '缓存命中',
+      'telemetry.cost': '预估成本',
+      'telemetry.limit': '预算限额',
     }
 
     function fallbackT(key, vars) {
@@ -1715,6 +1761,8 @@ window.__ModuleLoader__.load({
       { field: 'verificationGateEnabled', kind: 'bool', group: 'general' },
       { field: 'verificationCommand', kind: 'text', group: 'general' },
       { field: 'verificationTimeoutMs', kind: 'number', group: 'general' },
+      { field: 'costMeterEnabled', kind: 'bool', group: 'sync' },
+      { field: 'taskCostLimit', kind: 'number', group: 'limits' },
     ]
 
     function hintKey(spec) {
@@ -2014,6 +2062,29 @@ window.__ModuleLoader__.load({
         else if (!writable) note = h('p', { className: 'dkb-note', role: 'status' }, t('settings.readOnly'))
         else if (saved) note = h('p', { className: 'dkb-note', role: 'status' }, t('settings.saved'))
         else note = h('p', { className: 'dkb-note' })
+                const costMeterDetected = Boolean(ctx?.costMeter || (ctx?.registry && Array.from(ctx.registry.keys()).some((k) => k === '@goodandready/dsh-cost-meter' || k?.name === '@goodandready/dsh-cost-meter')))
+        rows.push(h('div', {
+          className: 'dkb-section-card',
+          key: 'cost-meter-notice',
+          style: {
+            borderLeft: '3px solid var(--dsw-alias-state-business-primary, #0969da)',
+            background: 'var(--dsw-alias-bg-layer-1, #f6f8fa)',
+            padding: '12px 14px',
+            marginBottom: '12px',
+          },
+        },
+          h('div', {
+            style: { display: 'flex', justifyContent: 'space-between', alignItems: 'center', marginBottom: '6px' },
+          },
+            h('span', { style: { fontWeight: '600', fontSize: '13px' } }, '🪙 ' + t('telemetry.title')),
+            h('span', {
+              className: 'dkb-section-badge' + (costMeterDetected ? ' dkb-section-badge-ok' : ''),
+            }, costMeterDetected ? t('costMeter.active') : t('costMeter.inactive')),
+          ),
+          h('p', { className: 'dkb-hint', style: { margin: 0, fontSize: '12px', lineHeight: '1.4' } },
+            t('costMeter.notice'),
+          ),
+        ))
         rows.push(h(PluginUpdaterSection, { t, key: 'updater' }))
         rows.push(h('div', { className: 'dkb-foot', key: 'foot' },
           note,
@@ -2094,6 +2165,20 @@ window.__ModuleLoader__.load({
             : (task.report?.verification?.status === 'failed'
               ? h('span', { className: 'dkb-tag', style: { background: 'var(--dsw-alias-state-error-secondary, #ffebe9)', color: 'var(--dsw-alias-state-error-primary, #cf222e)', borderColor: 'var(--dsw-alias-state-error-secondary, #ffc1c0)' }, title: task.report.verification.command || 'Tests failed' }, '✗ FAIL')
               : null),
+          task.costMetrics && task.costMetrics.totalTokens > 0
+            ? h('span', {
+                className: 'dkb-tag',
+                style: { background: 'var(--dsw-alias-state-business-tertiary, #ddf4ff)', color: 'var(--dsw-alias-state-business-primary, #0969da)', borderColor: 'var(--dsw-alias-state-business-tertiary, #54aeff)' },
+                title: 'Tokens: ' + task.costMetrics.totalTokens.toLocaleString()
+              }, '🪙 ' + (task.costMetrics.totalTokens / 1000).toFixed(1) + 'k' + (task.costMetrics.costFormatted ? ' · ' + task.costMetrics.costFormatted : ''))
+            : null,
+          task.costLimitExceeded
+            ? h('span', {
+                className: 'dkb-tag',
+                style: { background: 'var(--dsw-alias-state-warn-secondary, #fff8c5)', color: 'var(--dsw-alias-state-warn-primary, #9a6700)', borderColor: 'var(--dsw-alias-state-warn-secondary, #d4a72c)' },
+                title: 'Budget limit exceeded'
+              }, '⚠️ ' + t('card.costLimitExceeded'))
+            : null,
           task.report && task.report.summary
             ? h('span', { className: 'dkb-tag', title: 'Execution Report' }, '📄 report')
             : null,
@@ -2104,6 +2189,16 @@ window.__ModuleLoader__.load({
             className: 'dkb-tag', key: l, style: tagStyle(task, l),
           }, l))),
         h('div', { className: 'dkb-taskTitle' }, task.title),
+        task.state === 'running' && task.liveStep
+          ? h('div', {
+              className: 'dkb-liveStep',
+              style: { fontSize: '11px', color: 'var(--dsw-alias-state-business-primary, #0969da)', display: 'flex', alignItems: 'center', gap: '4px', margin: '3px 0' },
+              title: task.liveStep
+            },
+              h('span', { style: { display: 'inline-block' } }, '⟳'),
+              h('span', { style: { overflow: 'hidden', textOverflow: 'ellipsis', whiteSpace: 'nowrap' } }, task.liveStep)
+            )
+          : null,
         task.subtasksCount && task.subtasksCount.total > 0
           ? h('div', { className: 'dkb-progressBar', title: `${task.subtasksCount.completed}/${task.subtasksCount.total}` },
               h('div', {
@@ -2160,6 +2255,26 @@ window.__ModuleLoader__.load({
                 onClick: (e) => { e.stopPropagation(); props.onOpenChat(task) },
               }, t('card.toChat'))
               : null,
+            (task.column === 'in-progress' || task.col === 'in-progress') && task.sessionId && (task.state === 'running' || task.state === 'idle')
+              ? h('button', {
+                  type: 'button',
+                  className: 'dkb-nudgeBtn',
+                  title: t('card.nudgeHint'),
+                  style: {
+                    fontSize: '11px',
+                    padding: '1px 6px',
+                    borderRadius: '4px',
+                    cursor: 'pointer',
+                    border: '1px solid var(--dsw-alias-state-business-tertiary, #54aeff)',
+                    background: 'var(--dsw-alias-state-business-tertiary, #ddf4ff)',
+                    color: 'var(--dsw-alias-state-business-primary, #0969da)',
+                  },
+                  onClick: (e) => {
+                    e.stopPropagation();
+                    if (props.onNudge) props.onNudge(task);
+                  }
+                }, '💬 ' + t('card.nudge'))
+              : null,
             touched
               ? h('span', {
                 className: task.stale ? 'dkb-countOver' : '',
@@ -2317,6 +2432,32 @@ window.__ModuleLoader__.load({
       const [agentPreset, setAgentPreset] = React.useState('')
       const [permission, setPermission] = React.useState('')
       const dragged = React.useRef(null)
+      const [nudgeTask, setNudgeTask] = React.useState(null)
+      const [nudgePrompt, setNudgePrompt] = React.useState('')
+      const [nudgeSending, setNudgeSending] = React.useState(false)
+      const [nudgeSuccess, setNudgeSuccess] = React.useState(false)
+
+      const handleNudgeSubmit = React.useCallback(async () => {
+        if (!nudgeTask || !nudgePrompt.trim() || nudgeSending) return
+        setNudgeSending(true)
+        try {
+          await api('/task/' + encodeURIComponent(nudgeTask.id) + '/nudge', {
+            method: 'POST',
+            body: JSON.stringify({ prompt: nudgePrompt.trim() }),
+          })
+          setNudgeSuccess(true)
+          setTimeout(() => {
+            setNudgeTask(null)
+            setNudgePrompt('')
+            setNudgeSuccess(false)
+          }, 1200)
+          load(board)
+        } catch (e) {
+          setError(t(e.key || e.error || 'nudge.failed'))
+        } finally {
+          setNudgeSending(false)
+        }
+      }, [nudgeTask, nudgePrompt, nudgeSending, load, board, t])
 
       const load = React.useCallback(async (nextBoard) => {
         try {
@@ -2868,6 +3009,7 @@ window.__ModuleLoader__.load({
             if (manyGroups && groups[col.id + '/' + (task.repo || '')] === true) return
             rows.push(h(TaskCard, {
               key: task.id, task, t, now: state.now,
+              onNudge: (t) => { setNudgeTask(t); setNudgePrompt(''); setNudgeSuccess(false) },
               columns: (state.columns || []).map((c) => c.id),
               menuOpen: cardMenu,
               onMenu: setCardMenu,
@@ -3328,6 +3470,59 @@ window.__ModuleLoader__.load({
               },
             }, t('panel.openChat'))
             : null,
+          openTask.sessionId && (openTask.column === 'in-progress' || openTask.col === 'in-progress')
+            ? h('button', {
+              type: 'button', className: 'dkb-discard', style: { alignSelf: 'flex-start' },
+              onClick: () => { setNudgeTask(openTask); setNudgePrompt(''); setNudgeSuccess(false) },
+            }, '💬 ' + t('card.nudge'))
+            : null,
+          openTask.costMetrics && openTask.costMetrics.totalTokens > 0
+            ? h('div', {
+                className: 'dkb-section-card',
+                style: {
+                  margin: '8px 0', padding: 12, border: '1px solid var(--dsw-alias-border-l2)',
+                  borderRadius: 8, display: 'flex', flexDirection: 'column', gap: 6,
+                },
+              },
+                h('div', { style: { display: 'flex', justifyContent: 'space-between', alignItems: 'center' } },
+                  h('div', { className: 'dkb-group', style: { margin: 0, fontWeight: 600 } },
+                    '🪙 ' + t('telemetry.title')
+                  ),
+                  h('span', {
+                    className: 'dkb-tag',
+                    style: { background: 'var(--dsw-alias-state-business-tertiary, #ddf4ff)', color: 'var(--dsw-alias-state-business-primary, #0969da)', borderColor: 'var(--dsw-alias-state-business-tertiary, #54aeff)' }
+                  }, openTask.costMetrics.costFormatted || '$0.00'),
+                ),
+                h('div', { style: { display: 'grid', gridTemplateColumns: 'repeat(4, 1fr)', gap: 8, fontSize: '11px', textAlign: 'center' } },
+                  h('div', { style: { background: 'var(--dsw-alias-bg-layer-1)', padding: '6px', borderRadius: '4px' } },
+                    h('div', { style: { opacity: 0.7 } }, t('telemetry.tokens')),
+                    h('div', { style: { fontWeight: 600 } }, openTask.costMetrics.totalTokens.toLocaleString()),
+                  ),
+                  h('div', { style: { background: 'var(--dsw-alias-bg-layer-1)', padding: '6px', borderRadius: '4px' } },
+                    h('div', { style: { opacity: 0.7 } }, t('telemetry.input')),
+                    h('div', { style: { fontWeight: 600 } }, (openTask.costMetrics.uncachedInputTokens || 0).toLocaleString()),
+                  ),
+                  h('div', { style: { background: 'var(--dsw-alias-bg-layer-1)', padding: '6px', borderRadius: '4px' } },
+                    h('div', { style: { opacity: 0.7 } }, t('telemetry.output')),
+                    h('div', { style: { fontWeight: 600 } }, (openTask.costMetrics.outputTokens || 0).toLocaleString()),
+                  ),
+                  h('div', { style: { background: 'var(--dsw-alias-bg-layer-1)', padding: '6px', borderRadius: '4px' } },
+                    h('div', { style: { opacity: 0.7 } }, t('telemetry.cache')),
+                    h('div', { style: { fontWeight: 600 } }, (openTask.costMetrics.cacheReadTokens || 0).toLocaleString()),
+                  ),
+                ),
+                openTask.costLimitExceeded
+                  ? h('div', {
+                      style: {
+                        fontSize: '11px',
+                        color: 'var(--dsw-alias-state-warn-primary, #9a6700)',
+                        background: 'var(--dsw-alias-state-warn-secondary, #fff8c5)',
+                        padding: '4px 8px', borderRadius: '4px', marginTop: '4px'
+                      }
+                    }, '⚠️ ' + t('card.costLimitExceeded'))
+                  : null
+              )
+            : null,
           log.length
             ? h('div', null,
               h('div', { className: 'dkb-group' }, t('panel.log')),
@@ -4372,11 +4567,76 @@ window.__ModuleLoader__.load({
         )
         : null
 
+      const nudgeDialogEl = nudgeTask
+        ? h('div', {
+            className: 'dkb-modal',
+            onClick: () => { setNudgeTask(null); setNudgePrompt(''); setNudgeSuccess(false) },
+          },
+            h('div', {
+              className: 'dkb-dialog',
+              style: { maxWidth: '440px', width: '90%', padding: '16px' },
+              onClick: (e) => e.stopPropagation(),
+            },
+              h('div', { className: 'dkb-dialogHead', style: { display: 'flex', justifyContent: 'space-between', alignItems: 'center', marginBottom: '12px' } },
+                h('h3', { style: { margin: 0, fontSize: '15px' } }, t('nudge.title') + ': ' + (nudgeTask.title || '')),
+                h('button', {
+                  type: 'button',
+                  className: 'dkb-discard',
+                  style: { border: 'none', background: 'transparent', cursor: 'pointer', fontSize: '16px', padding: '0 4px' },
+                  onClick: () => { setNudgeTask(null); setNudgePrompt(''); setNudgeSuccess(false) },
+                }, '✕'),
+              ),
+              nudgeSuccess
+                ? h('div', {
+                    style: {
+                      padding: '12px',
+                      borderRadius: '6px',
+                      background: 'var(--dsw-alias-state-success-secondary, #dafbe1)',
+                      color: 'var(--dsw-alias-state-success-primary, #1a7f37)',
+                      marginBottom: '12px',
+                      textAlign: 'center',
+                      fontWeight: '600',
+                    },
+                  }, '✓ ' + t('nudge.success'))
+                : h('div', null,
+                    h('textarea', {
+                      className: 'dkb-area',
+                      style: { width: '100%', minHeight: '90px', marginBottom: '12px', boxSizing: 'border-box' },
+                      placeholder: t('nudge.placeholder'),
+                      value: nudgePrompt,
+                      autoFocus: true,
+                      onChange: (e) => setNudgePrompt(e.target.value),
+                      onKeyDown: (e) => {
+                        if (e.key === 'Enter' && (e.ctrlKey || e.metaKey)) {
+                          e.preventDefault();
+                          handleNudgeSubmit();
+                        }
+                      },
+                    }),
+                    h('div', { style: { display: 'flex', justifyContent: 'flex-end', gap: '8px' } },
+                      h('button', {
+                        type: 'button',
+                        className: 'dkb-discard',
+                        disabled: nudgeSending,
+                        onClick: () => { setNudgeTask(null); setNudgePrompt(''); setNudgeSuccess(false) },
+                      }, t('panel.close')),
+                      h('button', {
+                        type: 'button',
+                        className: 'dkb-save',
+                        disabled: !nudgePrompt.trim() || nudgeSending,
+                        onClick: handleNudgeSubmit,
+                      }, nudgeSending ? t('nudge.sending') : t('nudge.send')),
+                    ),
+                  ),
+            ),
+          )
+        : null;
+
       return h('div', { className: 'dkb-screen' },
         style, bar,
         error ? h('p', { className: 'dkb-failed' }, error) : null,
         metrics ? metricsEl : archive ? archiveEl : columns,
-        panel, dialogEl, moveDialogEl, batchEl, queueEl,
+        panel, dialogEl, moveDialogEl, batchEl, queueEl, nudgeDialogEl,
       )
     }
 

package/lib/config.js

@@ -79,6 +79,8 @@ export const CONFIG_DEFAULTS = {
   verificationGateEnabled: true,
   verificationCommand: 'npm test',
   verificationTimeoutMs: 120000,
+  costMeterEnabled: true,
+  taskCostLimit: 0,
 }
 
 /** Field descriptions reused in schema and settings card. */
@@ -117,6 +119,8 @@ export const CONFIG_HINTS = {
   verificationGateEnabled: 'Run automated verification gate (e.g. npm test) before allowing cards to move to Review.',
   verificationCommand: 'Default verification command to execute in task worktree before Review (default: npm test).',
   verificationTimeoutMs: 'Timeout in milliseconds for verification gate execution (default: 120000).',
+  costMeterEnabled: 'Enable token and cost telemetry integration via @goodandready/dsh-cost-meter.',
+  taskCostLimit: 'Cost threshold per task in USD; 0 disables threshold warnings.',
 }
 
 /** Setting key for column WIP limit; not all columns have limits. */

package/lib/cost-telemetry.js

@@ -0,0 +1,146 @@
+/**
+ * Token and cost telemetry integration with @goodandready/dsh-cost-meter (#374).
+ * All functions fail-soft without throwing when cost-meter is absent.
+ */
+
+/**
+ * Check whether @goodandready/dsh-cost-meter plugin is active in current runtime.
+ *
+ * @param {object} ctx - Cordis context
+ * @returns {boolean}
+ */
+export function isCostMeterAvailable(ctx) {
+  if (!ctx || typeof ctx !== 'object') return false
+  try {
+    if (ctx.costMeter || (typeof ctx.get === 'function' && ctx.get('costMeter'))) return true
+    if (ctx.settings && typeof ctx.settings.describe === 'function') {
+      const rows = ctx.settings.describe({ redactSecrets: true })
+      if (Array.isArray(rows) && rows.some((r) => r?.ns === 'dsh-cost-meter')) return true
+    }
+    if (ctx.registry && typeof ctx.registry[Symbol.iterator] === 'function') {
+      for (const [plugin] of ctx.registry) {
+        if (plugin === '@goodandready/dsh-cost-meter' || plugin?.name === '@goodandready/dsh-cost-meter') {
+          return true
+        }
+      }
+    }
+    return false
+  } catch {
+    return false
+  }
+}
+
+/**
+ * Extract aggregated token usage from a session's costByModel projection view.
+ *
+ * @param {object} projectionView - View object from usageByModelProjection
+ * @returns {{
+ *   totalTokens: number,
+ *   uncachedInputTokens: number,
+ *   outputTokens: number,
+ *   cacheReadTokens: number,
+ *   cacheWriteTokens: number,
+ *   turnsCount: number,
+ *   models: Array<string>
+ * }}
+ */
+export function extractSessionUsage(projectionView) {
+  const result = {
+    totalTokens: 0,
+    uncachedInputTokens: 0,
+    outputTokens: 0,
+    cacheReadTokens: 0,
+    cacheWriteTokens: 0,
+    turnsCount: 0,
+    models: [],
+  }
+  if (!projectionView || typeof projectionView !== 'object') return result
+
+  const modelsList = Array.isArray(projectionView.models) ? projectionView.models : []
+  for (const m of modelsList) {
+    const key = (m.provider ? m.provider + '/' : '') + (m.model || '')
+    if (key && !result.models.includes(key)) result.models.push(key)
+    const slots = m.slots && typeof m.slots === 'object' ? m.slots : {}
+    for (const slotKey of Object.keys(slots)) {
+      const b = slots[slotKey] || {}
+      result.uncachedInputTokens += Number(b.uncachedInputTokens) || 0
+      result.outputTokens += Number(b.outputTokens) || 0
+      result.cacheReadTokens += Number(b.cacheReadTokens) || 0
+      result.cacheWriteTokens += Number(b.cacheWriteTokens) || 0
+    }
+  }
+
+  if (Array.isArray(projectionView.turns)) {
+    result.turnsCount = projectionView.turns.length
+    if (result.totalTokens === 0 && projectionView.turns.length > 0) {
+      for (const t of projectionView.turns) {
+        result.uncachedInputTokens += Number(t.uncachedInputTokens) || 0
+        result.outputTokens += Number(t.outputTokens) || 0
+        result.cacheReadTokens += Number(t.cacheReadTokens) || 0
+        result.cacheWriteTokens += Number(t.cacheWriteTokens) || 0
+      }
+    }
+  }
+
+  result.totalTokens = result.uncachedInputTokens + result.outputTokens + result.cacheReadTokens + result.cacheWriteTokens
+  return result
+}
+
+/**
+ * Calculate cost for token usage given rate schedule or fallback tariff.
+ * Default tariff: standard DeepSeek rates ($0.14/M input, $0.28/M output, $0.014/M cache hit).
+ *
+ * @param {{
+ *   usage: object,
+ *   schedule?: object,
+ *   usdRate?: number,
+ *   currency?: string
+ * }} options
+ * @returns {{
+ *   costUsd: number,
+ *   costFormatted: string,
+ *   currency: string
+ * }}
+ */
+export function calculateTokenCost({ usage, schedule, usdRate = 1, currency = '$' }) {
+  if (!usage || typeof usage !== 'object') {
+    return { costUsd: 0, costFormatted: currency + '0.00', currency }
+  }
+
+  const uncachedInput = Number(usage.uncachedInputTokens) || 0
+  const output = Number(usage.outputTokens) || 0
+  const cacheRead = Number(usage.cacheReadTokens) || 0
+  const cacheWrite = Number(usage.cacheWriteTokens) || 0
+
+  const rateInput = Number(schedule?.inputPerMillion ?? schedule?.input) || 0.14
+  const rateOutput = Number(schedule?.outputPerMillion ?? schedule?.output) || 0.28
+  const rateCacheRead = Number(schedule?.cacheReadPerMillion ?? schedule?.cacheHit) || 0.014
+  const rateCacheWrite = Number(schedule?.cacheWritePerMillion) || rateInput
+
+  const costUsd = (uncachedInput * rateInput + output * rateOutput + cacheRead * rateCacheRead + cacheWrite * rateCacheWrite) / 1_000_000
+  const converted = costUsd * (Number(usdRate) > 0 ? Number(usdRate) : 1)
+
+  const costFormatted = currency + (converted < 0.01 && converted > 0 ? '<0.01' : converted.toFixed(2))
+
+  return {
+    costUsd: Math.round(costUsd * 10000) / 10000,
+    costFormatted,
+    currency,
+  }
+}
+
+/**
+ * Check whether task cost exceeds configured budget limit.
+ *
+ * @param {{ costUsd: number, limit: number }} options
+ * @returns {{ exceeded: boolean, limit: number, costUsd: number }}
+ */
+export function checkCostLimit({ costUsd = 0, limit = 0 }) {
+  const numLimit = Number(limit) || 0
+  if (numLimit <= 0) return { exceeded: false, limit: 0, costUsd }
+  return {
+    exceeded: costUsd >= numLimit,
+    limit: numLimit,
+    costUsd,
+  }
+}

package/lib/index.js

@@ -51,7 +51,9 @@ import {
   handleCreateSubtask,
   handleToggleChecklistItem,
   handleCreateTaskPr,
+  handleTaskNudge,
 } from './routes.js'
+import { isCostMeterAvailable } from './cost-telemetry.js'
 import { listImportable, importIssue, refreshTask, searchRepos, createProjectTask } from './import.js'
 import {
   runTask, resolveModel, buildStartMessage,
@@ -867,7 +869,20 @@ export function apply(ctx, config) {
   /**
    * Return active agent state or undefined if session is inactive.
    */
-  const liveOf = (sessionId) => ctx.agents.get(sessionId)?.status
+  const liveOf = (sessionId) => {
+    try {
+      const a = ctx.agents?.get?.(sessionId);
+      if (!a) return undefined;
+      return {
+        status: a.status || (typeof a.isIdle === 'function' && a.isIdle() ? 'idle' : 'running'),
+        state: a.state || a.lifecycleState,
+        step: a.step || a.currentStep || a.stateDetail || a.activity || '',
+        activity: a.activity || a.statusDetail || '',
+      };
+    } catch {
+      return undefined;
+    }
+  };
 
   ctx.effect(() => ctx.webServer.register({
     kind: 'exact',
@@ -885,6 +900,7 @@ export function apply(ctx, config) {
         sync: syncState.snapshot(),
         // Resolved project root passed with board payload for session launch modal.
         projectRoot: rootOf(getConfig()),
+        costMeterAvailable: isCostMeterAvailable(ctx),
       }))
     },
   }), 'dsh-kanban: board route')
@@ -1230,6 +1246,18 @@ export function apply(ctx, config) {
           writeJson(res, resObj.status, resObj.body)
           return
         }
+        if (req.method === 'POST' && (action === 'nudge' || (input && input.action === 'nudge'))) {
+          const resObj = await handleTaskNudge({
+            store,
+            id,
+            prompt: input?.prompt || input?.text,
+            agents: ctx.agents,
+            createMessage: createUserMessage,
+            eventHub,
+          })
+          writeJson(res, resObj.status, resObj.body)
+          return
+        }
         if (req.method === 'GET' && action === 'diff') {
           const resObj = await handleTaskDiff({ task: store.getTask(id), getTaskDiff, getTaskDiffInspector })
           writeJson(res, resObj.status, resObj.body)

package/lib/routes.js

@@ -308,10 +308,23 @@ function withPlan(task, liveOf, config, now, sameSession) {
   try {
     if (typeof liveOf === 'function' && task.sessionId) live = liveOf(task.sessionId)
   } catch { live = undefined }
+  const liveStatus = typeof live === 'object' && live !== null ? live.status : live
+  const liveStep = typeof live === 'object' && live !== null
+    ? (live.step || live.activity || live.stateDetail || '')
+    : ''
+
+  const costMetrics = task.costMetrics || null
+  const costLimitExceeded = (config?.costMeterEnabled !== false && Number(config?.taskCostLimit) > 0 && costMetrics?.costUsd)
+    ? costMetrics.costUsd >= Number(config.taskCostLimit)
+    : Boolean(task.costLimitExceeded)
+
   return {
     ...task,
     plan: { items: planItems(plan), progress: planProgress(plan) },
-    state: taskState({ task, live }),
+    state: taskState({ task, live: liveStatus }),
+    liveStep: liveStep || task.liveStep || '',
+    costMetrics,
+    costLimitExceeded,
     // Queue position calculated dynamically across active tasks in same session.
     queuePos: queuePosition(task, sameSession),
     // Label facets extracted on server for consistent client filtering.
@@ -344,7 +357,7 @@ function orderForBoard(tasks, columns) {
 /**
  * Build board response payload: columns in canonical order, tasks, and limits.
  */
-export function buildBoard({ store, config, board = 'main', repo, liveOf, sync, projectRoot }) {
+export function buildBoard({ store, config, board = 'main', repo, liveOf, sync, projectRoot, costMeterAvailable = false }) {
   // Uniform timestamp across snapshot calculation.
   const now = Date.now()
   // Tasks are sorted and grouped on server: repo grouping with active items first.
@@ -384,6 +397,7 @@ export function buildBoard({ store, config, board = 'main', repo, liveOf, sync,
     facets: facetsOf(tasks),
     // Sync telemetry state attached directly to board snapshot.
     sync: sync ?? { state: 'never' },
+    costMeterAvailable: Boolean(costMeterAvailable),
   }
 }
 
@@ -1119,4 +1133,75 @@ export async function handleCreateTaskPr({ store, gitea, task, input }) {
   } catch (err) {
     return { status: 502, body: { error: 'gitea-pr-failed', detail: err?.message } }
   }
-}
+}
+/**
+ * Handle interactive live steering (nudge) for an active task agent (#373).
+ *
+ * @param {{
+ *   store: object,
+ *   id: string,
+ *   prompt: string,
+ *   agents?: object,
+ *   createMessage?: Function,
+ *   eventHub?: object,
+ *   now?: number
+ * }} options
+ * @returns {Promise<{ status: number, body: object }>}
+ */
+export async function handleTaskNudge({ store, id, prompt, agents, createMessage, eventHub, now = Date.now() }) {
+  if (!store || !id) return { status: 400, body: { error: 'invalid-parameters' } }
+  const task = store.getTask(id)
+  if (!task) return { status: 404, body: { error: 'task-not-found' } }
+
+  const text = typeof prompt === 'string' ? prompt.trim() : ''
+  if (!text) return { status: 400, body: { error: 'prompt-required' } }
+
+  const sessionId = typeof task.sessionId === 'string' ? task.sessionId : ''
+  if (!sessionId) return { status: 409, body: { error: 'no-session' } }
+
+  let agent
+  try { agent = agents?.get?.(sessionId) } catch { agent = undefined }
+  if (!agent || typeof agent.followup !== 'function') {
+    return { status: 409, body: { error: 'session-not-live' } }
+  }
+
+  const msg = typeof createMessage === 'function'
+    ? createMessage({
+        content: [{ type: 'text', text }],
+        source: { kind: 'dsh-kanban', plugin: 'dsh-kanban', form: 'task-nudge' },
+      })
+    : { content: [{ type: 'text', text }] }
+
+  agent.followup(msg)
+
+  // Append user steering comment to task
+  if (typeof store.addComment === 'function') {
+    store.addComment(id, {
+      author: 'user',
+      role: 'user',
+      text: `[Steering Nudge] ${text}`,
+    })
+  } else if (typeof store.addTaskComment === 'function') {
+    store.addTaskComment(id, {
+      author: 'user',
+      role: 'user',
+      text: `[Steering Nudge] ${text}`,
+    })
+  }
+
+  // Broadcast change via eventHub
+  if (eventHub && typeof eventHub.broadcast === 'function') {
+    eventHub.broadcast('task:change', { id, col: task.col || task.column })
+  }
+
+  return {
+    status: 200,
+    body: {
+      success: true,
+      id,
+      sessionId,
+      prompt: text,
+      nudgedAt: now,
+    },
+  }
+}

package/lib/store.js

@@ -109,6 +109,7 @@ const WRITABLE = [
   'runs', 'checklist', 'report', 'comments', 'rejectReason', 'rejectedAt', 'parentId', 'isEpic',
   'workflowRunId', 'workflowStatus', 'permissionConfirmedTier', 'forge', 'queuedRequest',
   'verificationCommand', 'verificationStatus',
+  'costMetrics', 'costLimitExceeded',
 ]
 
 /** Valid transition sources; unexpected values are rejected to preserve log integrity. */
@@ -162,6 +163,16 @@ function rowToTask(row) {
     reasoningEffort: rest.reasoningEffort ?? '',
     isEpic: isEpic === 1,
     parentId: parentId ?? '',
+    costMetrics: (() => {
+      if (typeof rest.costMetrics === 'string' && rest.costMetrics.trim()) {
+        try {
+          const val = JSON.parse(rest.costMetrics);
+          if (val && typeof val === 'object') return val;
+        } catch {}
+      }
+      return rest.costMetrics && typeof rest.costMetrics === 'object' ? rest.costMetrics : null;
+    })(),
+    costLimitExceeded: rest.costLimitExceeded === 1 || rest.costLimitExceeded === true,
   }
 }
 
@@ -252,6 +263,8 @@ export function openStore({ dir }) {
     ['queuedRequest', "TEXT NOT NULL DEFAULT ''"],
     ['verificationCommand', "TEXT NOT NULL DEFAULT ''"],
     ['verificationStatus', "TEXT NOT NULL DEFAULT ''"],
+    ['costMetrics', "TEXT NOT NULL DEFAULT ''"],
+    ['costLimitExceeded', "INTEGER NOT NULL DEFAULT 0"],
   ]) {
     try { db.exec(`ALTER TABLE tasks ADD COLUMN ${column} ${definition}`) } catch { /* column already exists */ }
   }
@@ -653,6 +666,15 @@ export function openStore({ dir }) {
       })
     },
 
+    appendComment(id, comment) {
+      if (!comment || typeof comment !== 'object') return undefined
+      return this.addComment(id, {
+        author: comment.author || 'user',
+        role: comment.role || 'user',
+        text: comment.text || comment.body || '',
+      })
+    },
+
     updateChecklist(id, items) {
       const task = rowToTask(q.taskById.get(id))
       if (!task) return undefined

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@goodandready/dsh-kanban",
-  "version": "0.2.32",
+  "version": "0.2.33",
   "description": "Visual Kanban board for DeepSeek Harness: Gitea and GitHub-backed tasks, workflow columns, and a dedicated agent session per task.",
   "type": "module",
   "main": "lib/index.js",