dsh-agent-lines 0.3.3 → 0.3.5

package/CHANGELOG.en.md

@@ -2,6 +2,18 @@
 
 English | [中文](CHANGELOG.md)
 
+## 0.3.5 (2026-11-05)
+
+- Integrated P0/P1 bootstrap: line_create queues an onboarding message by default, adds bootstrapOnCreate, and line_status/line_list expose materialized / visibleInSidebar / bootstrapQueued.
+- Kept the 0.3.4 docs and wording; README bootstrap notes were added manually on top of 0.3.4, not overwritten from the older local tree.
+- No schema change; remains v6.
+
+## 0.3.4 (2026-11-05)
+
+- Removed the conflicting suggestion that one-off subtasks should use subagent / Agent Teams.
+- The plugin is positioned for long-running, multi-role teams that need durable messages; one-off subtasks are left to the user's DSH-native choice.
+- Synced the npm package and Release artifact; no runtime behavior change; schema remains v6.
+
 ## 0.3.3 (2026-11-04)
 
 - Scenario-first landing page: hero, three cards, four-step real usage, first-use claim prompt, restart note.

package/CHANGELOG.md

@@ -2,6 +2,18 @@
 
 [English](CHANGELOG.en.md) | 中文
 
+## 0.3.5 (2026-11-05)
+
+- 集成 P0/P1 bootstrap：line_create 默认排队 onboarding 消息，新增 bootstrapOnCreate，line_status/line_list 暴露 materialized / visibleInSidebar / bootstrapQueued。
+- 保留 0.3.4 的文档与删句；README 以 0.3.4 为基础手工补 bootstrap 说明，没有用本地旧版覆盖。
+- 无 schema 变化，仍为 v6。
+
+## 0.3.4 (2026-11-05)
+
+- 删除与插件定位冲突的提示句：不再在 README / 落地页建议“临时子任务直接用 subagent / Agent Teams”。
+- 明确插件用于长期、多角色、需要持久消息的团队；一次性临时子任务由用户按 DSH 原生能力自行选择。
+- 同步 npm 包与 Release 制品；无运行时行为变化，schema 仍为 v6。
+
 ## 0.3.3 (2026-11-04)
 
 - 落地页改为场景化：hero、三张卡、一个真实用法四步、首次使用含 line_claim_manager、重启提示。

package/README.en.md

@@ -22,7 +22,6 @@ Use it when:
 - Work must survive closing a window or restarting DSH: messages and context should still be there.
 - You want one lead agent to decompose work, create the team, track progress, collect results, and report back.
 
-If you only need temporary child tasks inside one session, use DSH subagents / Agent Teams; you do not need this plugin.
 
 ## Install
 
@@ -37,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.3.tgz
+    bash install.sh ./dsh-agent-lines-0.3.5.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.
 
@@ -65,6 +64,12 @@ After install and restart, it works without a config. When you want a fixed mana
 
 Only `createFrom` may call `line_create`. Worker profiles should leave `allowCreate` false.
 
+### New line bootstrap
+
+When the manager calls line_create, the plugin queues a no-work onboarding message by default so the blank Session gets its first message and appears in the sidebar; pass bootstrap: false to skip it.
+
+line_status / line_list return materialized, visibleInSidebar, and bootstrapQueued; a new line may remain blank until its first message.
+
 ## Quick start
 
 1. Run the installer above.
@@ -77,14 +82,15 @@ Only `createFrom` may call `line_create`. Worker profiles should leave `allowCre
 
 Copy this into a new root Session. The prompt starts with binding, then creates one team. Replace the task later; do not let the manager execute the work.
 
-> Use dsh-agent-lines. If this Session is not yet bound, call line_claim_manager with confirm "bind-manager". You are the development team lead: own task decomposition, assignment, communication, progress tracking, result collection, summary, and reporting. You only manage and coordinate; do not execute specific development tasks.
+> Use dsh-agent-lines. Make this Session the development team lead; bind it first if needed.
+>
+> You own task decomposition, assignment, coordination, progress tracking, result collection, and reporting. You manage and coordinate only; do not execute development tasks.
 >
-> Create these member lines with line_create. Use ASCII labels and Chinese roles:
-> research (调研), architecture (架构), uiux (UIUX), dev (开发), test (测试), acceptance (验收), release (发布), ops (运维).
+> Form the team. Use short English names and Chinese roles: research (调研), architecture (架构), uiux (UIUX), dev (开发), test (测试), acceptance (验收), release (发布), ops (运维).
 >
-> After creation, call line_list to confirm, then wait for my first task. Do not start work by yourself.
+> After the team is ready, wait for my first task. Do not start by yourself.
 
-Why ASCII labels: line labels are identifiers such as <code>research</code>; Chinese is the <code>role</code> text, not the label. This prompt creates one team. Version 0.3 does not support multiple simultaneous teams in one plugin instance.
+Member names are short English names; Chinese is the role. This prompt creates one team. Version 0.3 does not support multiple simultaneous teams in one plugin instance.
 
 Copyable calls (the manager Session runs these):
 

package/README.md

@@ -22,7 +22,6 @@ DSH 的 super agent 平替插件。
 - 任务做到一半关掉窗口、重启 DSH，消息和上下文还要在；
 - 你希望一个负责人 agent 自己拆任务、建团队、追进度、收结果，最后向你汇报。
 
-如果只是同一次会话里的临时子任务，直接用 DSH 内置的 subagent / Agent Teams，不需要这个插件。
 
 ## 安装
 
@@ -37,7 +36,7 @@ DSH 的 super agent 平替插件。
 
 离线或 npm 不可用时，用本地 tarball：
 
-    bash install.sh ./dsh-agent-lines-0.3.3.tgz
+    bash install.sh ./dsh-agent-lines-0.3.5.tgz
 
 安装并重启后，不写配置也可以直接使用；需要固定管理线/worker 时，再把下面“管理线配置”粘贴到脚本打印的配置文件。
 
@@ -65,6 +64,12 @@ DSH 的 super agent 平替插件。
 
 只有 `createFrom` 指定的线能调用 `line_create`。worker profile 不要开 `allowCreate`。
 
+### 新线 bootstrap
+
+管理线调用 line_create 创建新线时，插件默认排队一条不要求执行任务的 onboarding 消息，让空白 Session 产生第一条消息并出现在侧栏；传 bootstrap: false 可关闭。
+
+line_status / line_list 会返回 materialized、visibleInSidebar、bootstrapQueued；新线在首条消息前可能仍是 blank。
+
 ## 快速开始
 
 1. 运行上面的安装脚本。
@@ -77,15 +82,15 @@ DSH 的 super agent 平替插件。
 
 在新根会话里直接复制下面这段。它会先绑定管理线，再创建一支团队；后续任务再单独发，不要让它自己开工。
 
-> 使用 dsh-agent-lines。如果当前会话尚未绑定，先调用 line_claim_manager，confirm 用 "bind-manager"。
+> 使用 dsh-agent-lines。先把这个会话设为开发团队的管理线；如果还没绑定，就先完成绑定。
 >
-> 你是开发团队负责人：负责任务拆解与分配、协调团队沟通、跟踪成员工作状态与进度、汇总工作结果、总结并汇报。你只做管理和协调，不执行具体开发任务。
+> 你是开发团队负责人：负责任务拆解与分配、协调沟通、跟踪进度、汇总结果、总结汇报。你只做管理和协调，不执行具体开发任务。
 >
-> 请用 line_create 创建成员线，label 用英文，role 用中文：research（调研）、architecture（架构）、uiux（UIUX）、dev（开发）、test（测试）、acceptance（验收）、release（发布）、ops（运维）。
+> 请组建开发团队。成员名字用简短英文，岗位用中文：research（调研）、architecture（架构）、uiux（UIUX）、dev（开发）、test（测试）、acceptance（验收）、release（发布）、ops（运维）。
 >
-> 创建后用 line_list 确认，然后待命，等我发第一个任务；不要自行开始具体工作。
+> 团队建好后先待命，不要自动开工，等我发第一个任务。
 
-label 必须是 ASCII 标识符；中文放在 role 里，不要用中文 label。这个提示词只创建一个团队；0.3 不支持同一插件实例同时多个团队。
+成员名字用英文短名，中文放在岗位上。这个提示词只创建一个团队；0.3 不支持同一插件实例同时多个团队。
 
 可直接复制的调用（由管理线 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.3">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.5">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.3">Download 0.3.3</a>
+      <a class="btn" href="https://github.com/Lencen/dsh-agent-lines/releases/tag/v0.3.5">Download 0.3.5</a>
     </div>
   </div>
   <div class="shot">
@@ -69,7 +69,7 @@ footer{padding:34px 0 48px;color:var(--muted);font-size:12px}
     <div class="card"><b>No manual dispatch</b><p>The lead decomposes work, assigns it, coordinates, resolves disagreements, and collects results. You read the summary.</p></div>
     <div class="card"><b>No lost work</b><p>Tasks and messages are stored locally. Restart DSH and continue; member state and unread messages are still there.</p></div>
   </div>
-  <p style="color:var(--muted);font-size:14px;margin-top:14px">Built for long-running projects and multi-role work. For a one-off subtask, DSH's built-in subagent / Agent Teams is simpler.</p>
+  <p style="color:var(--muted);font-size:14px;margin-top:14px">Built for long-running projects and multi-role work.</p>
 </section>
 <section>
   <h2>A real usage pattern</h2>
@@ -82,13 +82,17 @@ footer{padding:34px 0 48px;color:var(--muted);font-size:12px}
 </section>
 <section>
   <h2>First use: let the lead form the team</h2>
-  <pre>You are the development team lead: own decomposition, assignment, coordination, tracking, and summary.
-First bind this Session with line_claim_manager, then use line_create for:
-research / architecture / uiux / dev / test / acceptance / release / ops
-After creation, confirm with line_list, then wait for my first task.</pre>
+  <pre>Use dsh-agent-lines. Make this Session the development team lead; bind it first if needed.
+
+You own task decomposition, assignment, coordination, progress tracking, result collection, and reporting. You manage and coordinate only; do not execute development tasks.
+
+Form the team. Use short English names and Chinese roles:
+research (调研), architecture (架构), uiux (UIUX), dev (开发), test (测试), acceptance (验收), release (发布), ops (运维).
+
+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.3 · Apache-2.0 · Community plugin for DeepSeek Harness. Not an official DeepSeek product.</footer>
+<footer>dsh-agent-lines 0.3.5 · 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.3">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.5">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.3">下载 0.3.3</a>
+      <a class="btn" href="https://github.com/Lencen/dsh-agent-lines/releases/tag/v0.3.5">下载 0.3.5</a>
     </div>
   </div>
   <div class="shot">
@@ -69,7 +69,7 @@ footer{padding:34px 0 48px;color:var(--muted);font-size:12px}
     <div class="card"><b>不用自己当调度</b><p>负责人拆任务、分配、协调、处理分歧、收结果；你只需要看最后的汇总。</p></div>
     <div class="card"><b>不用怕关窗口</b><p>任务和消息保存在本地；重启 DSH 后还能接着做，成员状态和未处理消息都在。</p></div>
   </div>
-  <p style="color:var(--muted);font-size:14px;margin-top:14px">适合长期项目、多角色协作；一次性的临时子任务，直接用 DSH 内置 subagent / Agent Teams 更简单。</p>
+  <p style="color:var(--muted);font-size:14px;margin-top:14px">适合长期项目、多角色协作。</p>
 </section>
 <section>
   <h2>一个真实用法</h2>
@@ -82,13 +82,17 @@ footer{padding:34px 0 48px;color:var(--muted);font-size:12px}
 </section>
 <section>
   <h2>首次使用：让负责人自己组队</h2>
-  <pre>你是开发团队负责人：负责任务拆解、分配、协调、跟踪、汇总。
-先用 line_claim_manager 把当前会话绑定为管理线，再用 line_create 创建：
-research / architecture / uiux / dev / test / acceptance / release / ops
-创建后用 line_list 确认，然后待命，等我发第一个任务。</pre>
+  <pre>使用 dsh-agent-lines。先把这个会话设为开发团队的管理线；如果还没绑定，就先完成绑定。
+
+你是开发团队负责人：负责任务拆解与分配、协调沟通、跟踪进度、汇总结果、总结汇报。你只做管理和协调，不执行具体开发任务。
+
+请组建开发团队。成员名字用简短英文，岗位用中文：
+research（调研）、architecture（架构）、uiux（UIUX）、dev（开发）、test（测试）、acceptance（验收）、release（发布）、ops（运维）。
+
+团队建好后先待命，不要自动开工，等我发第一个任务。</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.3 · Apache-2.0 · Community plugin for DeepSeek Harness. Not an official DeepSeek product.</footer>
+<footer>dsh-agent-lines 0.3.5 · 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.3"
+        "latest": "0.3.5"
       },
       "versions": [
         {
-          "version": "0.3.3",
+          "version": "0.3.5",
           "publishTimestamp": 1793771000,
           "source": {
             "type": "npm"

package/examples/market-index.json

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

package/lib/index.js

@@ -74,6 +74,7 @@ export function normalizeConfig(raw = {}) {
     maxLines: integer(raw.maxLines, 16, { min: Math.max(1, lines.length), max: 256 }),
     allowCreate: raw.allowCreate === undefined ? zeroConfig : raw.allowCreate === true,
     allowClaim: raw.allowClaim === undefined ? zeroConfig : raw.allowClaim === true,
+    bootstrapOnCreate: raw.bootstrapOnCreate === undefined ? true : raw.bootstrapOnCreate === true,
     allowSelfSend: raw.allowSelfSend === true,
     dedupeWindowMs: integer(raw.dedupeWindowMs, 5_000, { min: 0, max: 3_600_000 }),
     maxReplyDepth: integer(raw.maxReplyDepth, 8, { min: 1, max: 100 }),
@@ -334,8 +335,38 @@ export async function apply(ctx, rawConfig) {
     if (agent !== undefined) bindAgent(agent)
     try {
       await ctx.sessionController.rename({ sessionId: actualSessionId, title: `line: ${label}` })
-    } catch { /* a blank session may not materialize on rename; first delivery will */ }
-    return { line: label, sessionId: actualSessionId, role, cwd: targetWorkspace?.path ?? cwd, workspaceId: targetWorkspace?.id ?? null, created: true }
+    } catch { /* a blank session may not materialize on rename; bootstrap/first delivery will */ }
+    let bootstrapQueued = false
+    if (args.bootstrap !== false && config.bootstrapOnCreate !== false && creator !== undefined) {
+      try {
+        store.send({
+          agentId: config.agentId,
+          fromLine: creator.label,
+          to: label,
+          text: `[Agent Line] ${label} onboarding. You are ${role ?? label}. This is an identity message: do not start work and do not modify files. Acknowledge briefly if needed, then wait for the manager's first task.`,
+          noReply: true,
+          maxReplyDepth: config.maxReplyDepth,
+          maxMessageBytes: config.maxMessageBytes,
+        })
+        bootstrapQueued = true
+      } catch (error) {
+        ctx.logger?.warn?.('agent-lines: line %s created but onboarding bootstrap failed: %s', label, String(error))
+      }
+    }
+    return {
+      line: label,
+      sessionId: actualSessionId,
+      role,
+      cwd: targetWorkspace?.path ?? cwd,
+      workspaceId: targetWorkspace?.id ?? null,
+      created: true,
+      materialized: false,
+      visibleInSidebar: false,
+      bootstrapQueued,
+      hint: bootstrapQueued
+        ? 'Onboarding message queued; the Session becomes visible after its first turn.'
+        : 'No bootstrap queued; send a standby message or refresh after the first delivery.',
+    }
   }
 
   try {

package/lib/tools.js

@@ -37,6 +37,17 @@ function limitValue(value, fallback, max) {
   return number
 }
 
+function materializationOf(ctx, sessionId) {
+  const live = ctx.agents.get(sessionId)
+  if (live === undefined) return null
+  const projections = ctx.get?.('sessionProjections')
+  if (projections?.snapshot === undefined) return null
+  try {
+    const meta = projections.snapshot(live.session, ['sessionListMetadata'])?.values?.sessionListMetadata
+    return meta === undefined ? null : meta.blank === false
+  } 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,
@@ -87,6 +98,7 @@ export function registerStatusTool(ctx, { config, store, lineDefs }) {
         createdBy: line.created_by,
         lease: line.lease,
         live: ctx.agents.get(line.session_id) !== undefined,
+        materialized: materializationOf(ctx, line.session_id),
       }))
       const current = currentId === undefined
         ? null
@@ -103,7 +115,7 @@ export function registerStatusTool(ctx, { config, store, lineDefs }) {
           : config.allowClaim
             ? `Current Session is not bound. Call line_claim_manager({ confirm: "bind-manager" }) to bind this root Session.`
             : `Current Session is not bound. Run: dsh-agent-lines claim --agent ${config.agentId} --line ${config.createFrom} --session ${currentId} (set allowClaim: true first)`
-      return { current, manager, lines, allowClaim: config.allowClaim, repair }
+      return { current, manager, lines, allowClaim: config.allowClaim, bootstrapOnCreate: config.bootstrapOnCreate, repair }
     },
   })
 }
@@ -155,7 +167,11 @@ export function registerToolsForAgent(agent, def, { config, store, lineDefs, cre
     output: OUTPUT,
     execute: async (_args, exec) => {
       const current = lineDefs.get(exec?.agent?.session?.id)
-      return { current: currentView(current), lines: store.listLines() }
+      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) })),
+        bootstrapOnCreate: config.bootstrapOnCreate,
+      }
     },
   }))
 
@@ -268,7 +284,7 @@ export function registerToolsForAgent(agent, def, { config, store, lineDefs, cre
   if (config.allowCreate === true && def.label === config.createFrom) {
     disposers.push(agent.ctx.tools.register({
       name: 'line_create',
-      description: 'Create a new independent DSH Session in this process and register it as an agent line, so it can be addressed with line_send. Only the configured manager line (createFrom) may call this. Reusing an existing label returns created:false without creating a Session. This does not create a separate OS process or transfer an existing Session.',
+      description: 'Create a new independent DSH Session in this process and register it as an agent line, so it can be addressed with line_send. Only the configured manager line (createFrom) may call this. Reusing an existing label returns created:false without creating a Session. By default the plugin queues a no-work onboarding message so the Session becomes non-blank and appears in the sidebar; pass bootstrap:false to skip it.',
       parameters: {
         type: 'object',
         additionalProperties: false,
@@ -278,6 +294,7 @@ export function registerToolsForAgent(agent, def, { config, store, lineDefs, cre
           agentPreset: { type: 'string', description: 'DSH agent preset; defaults to the plugin childPreset' },
           workspace: { type: 'string', description: 'Target workspace path or id; defaults to the manager workspace. Existing workspace only.' },
           cwd: { type: 'string', description: 'Working directory when no workspace is named; defaults to the manager Session cwd' },
+          bootstrap: { type: 'boolean', description: 'Queue a no-work onboarding message so the new Session appears in the sidebar; defaults to config.bootstrapOnCreate' },
         },
         required: ['label'],
       },

package/package.json

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