dsh-agent-lines 0.3.7 → 0.3.8

package/CHANGELOG.en.md

@@ -2,6 +2,13 @@
 
 English | [中文](CHANGELOG.md)
 
+## 0.3.8 (2026-11-09)
+
+- line_status / line_list expose activity: turns/steps/decodeTokens/level/lastActivityAt.
+- activityLevel is an activity proxy, not a context-window percentage; DSH does not expose context usage.
+- Remains compatible with the 0.3.6/0.3.7 lifecycle/title work.
+- Tests 35/35 pass.
+
 ## 0.3.7 (2026-11-09)
 
 - Added line_handoff: structured handoff snapshots (JSON/Markdown), no model call.

package/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 [English](CHANGELOG.en.md) | 中文
 
+## 0.3.8 (2026-11-09)
+
+- line_status / line_list 增加 activity：turns/steps/decodeTokens/level/lastActivityAt。
+- 明确 activityLevel 只是活跃度代理，不是 contextUsage 百分比；DSH 未暴露上下文窗口。
+- 生命周期/标题/在飞版本保持 0.3.6/0.3.7 兼容。
+- 测试 35/35 通过。
+
 ## 0.3.7 (2026-11-09)
 
 - 新增 line_handoff：结构化交接快照（JSON/Markdown），不调用模型。

package/README.en.md

@@ -36,7 +36,7 @@ The script picks the DSH Web profile, installs the plugin, and verifies agent-li
 
 Offline or when npm is unavailable, use the local tarball:
 
-    bash install.sh ./dsh-agent-lines-0.3.7.tgz
+    bash install.sh ./dsh-agent-lines-0.3.8.tgz
 
 After install and restart, it works without a config. When you want a fixed manager/worker setup, paste the "Manager config" block below into the file printed by the installer.
 
@@ -134,7 +134,7 @@ Tools:
 
 | Tool | Purpose |
 |---|---|
-| `line_status` | Read-only: current Session binding, manager Session live/persisted, lines, repair command; visible even when unbound |
+| `line_status` | Read-only: current Session binding, manager Session live/persisted, lines, repair command; visible even when unbound; includes activity (not contextUsage) |
 | `line_claim_manager` | Bind this live root Session as manager; requires `allowClaim: true` and `confirm: "bind-manager"`; global, no shell needed |
 | `line_list` | List lines, status, unread counts, current line and role |
 | `line_create` | Manager only: create a line; same label is idempotent; replace:true swaps the label to a fresh Session |
@@ -155,7 +155,7 @@ Line tools other than `line_status` and `line_claim_manager` are registered only
 
 A line does not inherit the old Session context. Recommended flow:
 
-1. Have the old line write a handoff file (line_handoff is available from 0.3.7);
+1. Have the old line write a handoff file (line_handoff is available from 0.3.8);
 2. The manager calls `line_create({ label, replace: true, force: true, reason: "context full" })`;
 3. The plugin creates a clean Session, atomically swaps the same label, and marks the old Session retired but keeps it;
 4. queued/claimed messages migrate to the new line; delivered/acked stay on the old Session and are never re-delivered.

package/README.md

@@ -36,7 +36,7 @@ DSH 的 super agent 平替插件。
 
 离线或 npm 不可用时，用本地 tarball：
 
-    bash install.sh ./dsh-agent-lines-0.3.7.tgz
+    bash install.sh ./dsh-agent-lines-0.3.8.tgz
 
 安装并重启后，不写配置也可以直接使用；需要固定管理线/worker 时，再把下面“管理线配置”粘贴到脚本打印的配置文件。
 
@@ -124,6 +124,11 @@ line_create({ label: "ops", role: "运维" })
 
 这只是“用提示词组织团队”的方式，不是插件内置的组织架构；怎么拆任务由负责人模型决定。技术细节（消息、状态、工具）在下面的“使用”和“投递语义”。
 
+## 上下文活跃度
+
+line_status / line_list 返回 activity：turns/steps/decodeTokens/level/lastActivityAt。
+level 是活跃度代理（low/medium/high），不是上下文使用率百分比；DSH 当前不暴露上下文窗口。
+
 ## 使用
 
 管理线可以完全由对话驱动：
@@ -134,7 +139,7 @@ line_create({ label: "ops", role: "运维" })
 
 | 工具 | 作用 |
 |---|---|
-| `line_status` | 只读：当前会话绑定、manager Session 是否存在/live、线列表、修复命令；未绑定也可见 |
+| `line_status` | 只读：当前会话绑定、manager Session 是否存在/live、线列表、修复命令；未绑定也可见；含 activity 活跃度（不是 contextUsage） |
 | `line_claim_manager` | 把当前 live 根 Session 绑成 manager；需要 `allowClaim: true` 和 `confirm: "bind-manager"`；全局工具，不需要 shell |
 | `line_list` | 列出线、状态、未读数、当前线和 role |
 | `line_create` | 仅管理线：创建新线；同 label 幂等；传 replace:true 可给同 label 换新 Session |
@@ -155,7 +160,7 @@ line_create({ label: "ops", role: "运维" })
 
 线不会自动继承旧 Session 的上下文。推荐流程：
 
-1. 让旧线写交接单（0.3.7 起可用 `line_handoff`）；
+1. 让旧线写交接单（0.3.8 起可用 `line_handoff`）；
 2. 管理线调用 `line_create({ label, replace: true, force: true, reason: "context full" })`；
 3. 插件创建干净 Session、同 label 原子切换，旧 Session 标记 retired 但保留；
 4. queued/claimed 消息迁移到新线；delivered/acked 留在旧 Session，不重投。

package/docs/en/index.html

@@ -43,7 +43,7 @@ footer{padding:34px 0 48px;color:var(--muted);font-size:12px}
 <div class="wrap">
 <header>
   <a class="brand" href="../"><span class="mark"></span>dsh-agent-lines</a>
-  <nav><a href="../">中文</a><a href="https://github.com/Lencen/dsh-agent-lines">GitHub</a><a href="https://github.com/Lencen/dsh-agent-lines/releases/tag/v0.3.7">Release</a></nav>
+  <nav><a href="../">中文</a><a href="https://github.com/Lencen/dsh-agent-lines">GitHub</a><a href="https://github.com/Lencen/dsh-agent-lines/releases/tag/v0.3.8">Release</a></nav>
 </header>
 <main>
 <section class="hero" style="border:0;padding-bottom:22px">
@@ -54,7 +54,7 @@ footer{padding:34px 0 48px;color:var(--muted);font-size:12px}
     <div class="install">curl -fsSL https://raw.githubusercontent.com/Lencen/dsh-agent-lines/main/install.sh -o install.sh &amp;&amp; bash install.sh</div>
     <div class="actions">
       <a class="btn primary" href="https://github.com/Lencen/dsh-agent-lines">GitHub repository</a>
-      <a class="btn" href="https://github.com/Lencen/dsh-agent-lines/releases/tag/v0.3.7">Download 0.3.7</a>
+      <a class="btn" href="https://github.com/Lencen/dsh-agent-lines/releases/tag/v0.3.8">Download 0.3.8</a>
     </div>
   </div>
   <div class="shot">
@@ -92,7 +92,7 @@ research (调研), architecture (架构), uiux (UIUX), dev (开发), test (测
 After the team is ready, wait for my first task. Do not start by yourself.</pre>
   <p style="color:var(--muted);font-size:14px">Restart DSH Web after install or update. Technical details, protocol, and limits: <a href="https://github.com/Lencen/dsh-agent-lines">README / architecture</a>. Community plugin, not an official DeepSeek product.</p>
 </section>
-<footer>dsh-agent-lines 0.3.7 · Apache-2.0 · Community plugin for DeepSeek Harness. Not an official DeepSeek product.</footer>
+<footer>dsh-agent-lines 0.3.8 · Apache-2.0 · Community plugin for DeepSeek Harness. Not an official DeepSeek product.</footer>
 </main>
 </div>
 </body>

package/docs/index.html

@@ -43,7 +43,7 @@ footer{padding:34px 0 48px;color:var(--muted);font-size:12px}
 <div class="wrap">
 <header>
   <a class="brand" href="./"><span class="mark"></span>dsh-agent-lines</a>
-  <nav><a href="en/index.html">English</a><a href="https://github.com/Lencen/dsh-agent-lines">GitHub</a><a href="https://github.com/Lencen/dsh-agent-lines/releases/tag/v0.3.7">Release</a></nav>
+  <nav><a href="en/index.html">English</a><a href="https://github.com/Lencen/dsh-agent-lines">GitHub</a><a href="https://github.com/Lencen/dsh-agent-lines/releases/tag/v0.3.8">Release</a></nav>
 </header>
 <main>
 <section class="hero" style="border:0;padding-bottom:22px">
@@ -54,7 +54,7 @@ footer{padding:34px 0 48px;color:var(--muted);font-size:12px}
     <div class="install">curl -fsSL https://raw.githubusercontent.com/Lencen/dsh-agent-lines/main/install.sh -o install.sh &amp;&amp; bash install.sh</div>
     <div class="actions">
       <a class="btn primary" href="https://github.com/Lencen/dsh-agent-lines">GitHub 仓库</a>
-      <a class="btn" href="https://github.com/Lencen/dsh-agent-lines/releases/tag/v0.3.7">下载 0.3.7</a>
+      <a class="btn" href="https://github.com/Lencen/dsh-agent-lines/releases/tag/v0.3.8">下载 0.3.8</a>
     </div>
   </div>
   <div class="shot">
@@ -92,7 +92,7 @@ research（调研）、architecture（架构）、uiux（UIUX）、dev（开发
 团队建好后先待命，不要自动开工，等我发第一个任务。</pre>
   <p style="color:var(--muted);font-size:14px">安装或更新后需要重启 DSH Web。技术细节、协议和限制见 <a href="https://github.com/Lencen/dsh-agent-lines">README / 架构文档</a>。社区插件，不是 DeepSeek 官方产品。</p>
 </section>
-<footer>dsh-agent-lines 0.3.7 · Apache-2.0 · Community plugin for DeepSeek Harness. Not an official DeepSeek product.</footer>
+<footer>dsh-agent-lines 0.3.8 · Apache-2.0 · Community plugin for DeepSeek Harness. Not an official DeepSeek product.</footer>
 </main>
 </div>
 </body>

package/docs/market-index.json

@@ -50,11 +50,11 @@
         ]
       },
       "dist-tags": {
-        "latest": "0.3.7"
+        "latest": "0.3.8"
       },
       "versions": [
         {
-          "version": "0.3.7",
+          "version": "0.3.8",
           "publishTimestamp": 1793771000,
           "source": {
             "type": "npm"

package/examples/market-index.json

@@ -50,11 +50,11 @@
         ]
       },
       "dist-tags": {
-        "latest": "0.3.7"
+        "latest": "0.3.8"
       },
       "versions": [
         {
-          "version": "0.3.7",
+          "version": "0.3.8",
           "publishTimestamp": 1793771000,
           "source": {
             "type": "npm"

package/lib/activity.js

@@ -0,0 +1,19 @@
+/** Pure activity summarizer. Never claims a context-window percentage. */
+export function activityLevel({ steps = 0, turns = 0 } = {}) {
+  const n = Number(steps) || 0
+  if (n >= 40) return 'high'
+  if (n >= 15) return 'medium'
+  return 'low'
+}
+
+export function summarizeActivity(stats, lastActivityAt = null) {
+  if (stats === undefined || stats === null) return null
+  const turns = Number(stats.turns) || 0
+  const steps = Number(stats.steps) || 0
+  return {
+    turns, steps,
+    decodeTokens: Number(stats.decodeTokens) || 0,
+    level: activityLevel({ steps, turns }),
+    lastActivityAt: lastActivityAt === null ? null : Number(lastActivityAt),
+  }
+}

package/lib/tools.js

@@ -5,6 +5,7 @@
  */
 import { createHash } from 'node:crypto'
 import { LineError, assertMessageSize, lineId, parseTarget } from './protocol.js'
+import { summarizeActivity } from './activity.js'
 
 const OUTPUT = {
   schema: { type: 'object', additionalProperties: true },
@@ -48,6 +49,16 @@ function materializationOf(ctx, sessionId) {
   } catch { return null }
 }
 
+function activityOf(ctx, sessionId) {
+  const projections = ctx.get?.('sessionProjections')
+  const agent = ctx.agents.get(sessionId)
+  if (projections?.snapshot === undefined || agent === undefined) return null
+  try {
+    const snapshot = projections.snapshot(agent.session, ['sessionStats'])
+    return summarizeActivity(snapshot?.values?.sessionStats, null)
+  } catch { return null }
+}
+
 function currentView(def) {
   return def === undefined ? null : {
     agentId: def.agentId, line: def.label, sessionId: def.sessionId, lineId: def.lineId, role: def.role,
@@ -106,6 +117,7 @@ export function registerStatusTool(ctx, { config, store, lineDefs }) {
         lease: line.lease,
         live: ctx.agents.get(line.session_id) !== undefined,
         materialized: materializationOf(ctx, line.session_id),
+        activity: activityOf(ctx, line.session_id),
       }))
       const current = currentId === undefined
         ? null
@@ -178,7 +190,7 @@ export function registerToolsForAgent(agent, def, { config, store, lineDefs, cre
       const current = lineDefs.get(exec?.agent?.session?.id)
       return {
         current: currentView(current),
-        lines: store.listLines().map(line => ({ ...line, live: agent.ctx.agents.get(line.session_id) !== undefined, materialized: materializationOf(agent.ctx, line.session_id) })),
+        lines: store.listLines().map(line => ({ ...line, live: agent.ctx.agents.get(line.session_id) !== undefined, materialized: materializationOf(agent.ctx, line.session_id), activity: activityOf(agent.ctx, line.session_id) })),
         bootstrapOnCreate: config.bootstrapOnCreate,
       }
     },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-agent-lines",
-  "version": "0.3.7",
+  "version": "0.3.8",
   "description": "DSH Agent 的持久、可寻址消息线（社区插件）。",
   "type": "module",
   "license": "Apache-2.0",