dsh-agent-lines 0.3.4 → 0.3.5

package/CHANGELOG.en.md

@@ -2,6 +2,12 @@
 
 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.

package/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 [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”。

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.4.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.
 
@@ -64,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.

package/README.md

@@ -36,7 +36,7 @@ DSH 的 super agent 平替插件。
 
 离线或 npm 不可用时，用本地 tarball：
 
-    bash install.sh ./dsh-agent-lines-0.3.4.tgz
+    bash install.sh ./dsh-agent-lines-0.3.5.tgz
 
 安装并重启后，不写配置也可以直接使用；需要固定管理线/worker 时，再把下面“管理线配置”粘贴到脚本打印的配置文件。
 
@@ -64,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. 运行上面的安装脚本。

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.4">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.4">Download 0.3.4</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">
@@ -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.4 · 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.4">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.4">下载 0.3.4</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">
@@ -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.4 · 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.4"
+        "latest": "0.3.5"
       },
       "versions": [
         {
-          "version": "0.3.4",
+          "version": "0.3.5",
           "publishTimestamp": 1793771000,
           "source": {
             "type": "npm"

package/examples/market-index.json

@@ -50,11 +50,11 @@
         ]
       },
       "dist-tags": {
-        "latest": "0.3.4"
+        "latest": "0.3.5"
       },
       "versions": [
         {
-          "version": "0.3.4",
+          "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.4",
+  "version": "0.3.5",
   "description": "DSH Agent 的持久、可寻址消息线（社区插件）。",
   "type": "module",
   "license": "Apache-2.0",