@zhushanwen/pi-scheduler 0.11.1 → 0.11.2

package/README.md

@@ -28,15 +28,9 @@ npm install @zhushanwen/pi-scheduler
 
 安装后扩展在 pi 会话启动时自动装配（见下节），无需额外配置。
 
-## 工具激活（deferred）
+## 工具激活
 
-`schedule` / `schedule_control` 工具注册为 `exposure: "deferred"`——不占常驻工具声明，由 pi 内置 `tool_search` 工具检索命中后按需激活。taiji 宿主内开箱即用（宿主启动时已激活 `tool_search`）；独立 pi 使用需在 `<agentDir>/settings.json`（默认 `~/.pi/agent/settings.json`）开启：
-
-```json
-{ "defaultTools": ["+tool_search"] }
-```
-
-`+` 前缀是增量修饰（保留 read/bash/edit/write 默认集）。未开启 `tool_search` 时这两个工具对模型不可见。
+`schedule` / `schedule_control` 两工具均为 direct 常驻——注册不声明 `exposure` 字段（pi SDK 缺省 `direct`），工具声明随会话常驻、对模型默认可见，无需经 `tool_search` 检索激活，独立 pi 开箱即用。
 
 ## 激活方式
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhushanwen/pi-scheduler",
-  "version": "0.11.1",
+  "version": "0.11.2",
   "type": "module",
   "main": "index.ts",
   "taiji": {

package/src/__tests__/sdk-contract.test.ts

@@ -17,7 +17,7 @@
 // 读取——若在 factory 顶层捕获 service! 非空断言，注册时 service 为 null，
 // execute 调用会 NPE。此套件验证 session_start 前 execute 优雅 throw 而非 crash。
 
-import type { ExtensionAPI, ExtensionContext } from '@earendil-works/pi-coding-agent'
+import type { ExtensionAPI, ExtensionContext, Theme } from '@earendil-works/pi-coding-agent'
 import { describe, expect, it, vi } from 'vitest'
 
 // MF-3：session_start handler 会真实执行 importLegacyStore(ctx.cwd, ...) —— fakeCtx cwd='/test'
@@ -105,6 +105,40 @@ describe('pi-scheduler SDK contract', () => {
     }
   })
 
+  // exposure 重划终态锚（C-ext-05，2026-10-23 ADR-0136）：两工具保持 direct 常驻 =
+  // 注册时不写 exposure 字段（SDK 缺省 direct，pi-semantics PS-91）——误写 "deferred" 会把
+  // 触发入口从模型默认可见集收走（tool_search 才可激活），此处红。
+  it('exposure 注册终态：schedule / schedule_control 均 direct 常驻（不写 exposure 字段，SDK 缺省）', () => {
+    const { pi, tools } = createMockPi()
+    schedulerExtension(pi)
+    expect(tools.map(t => t.name).sort()).toEqual(['schedule', 'schedule_control'])
+    for (const tool of tools) {
+      expect(tool.exposure).toBeUndefined()
+    }
+  })
+
+  it('每个 tool 有 renderResult 函数成员（C-ext-05）+ 折叠态输出 details.summary 一行', () => {
+    const { pi, tools } = createMockPi()
+    schedulerExtension(pi)
+    for (const tool of tools) {
+      expect(typeof tool.renderResult).toBe('function')
+      const renderResult = tool.renderResult as (
+        result: unknown,
+        options: { expanded: boolean },
+        theme: Theme,
+      ) => { render: (width: number) => string[] }
+      const renderTheme = { fg: (_token: string, text: string) => text } as unknown as Theme
+      const result = {
+        content: [{ type: 'text', text: 'schedule output…' }],
+        details: { summary: 'Scheduled reminder in 5m' },
+      }
+      // Text.render 按宽度 pad，trim 后断言（折叠态 = details.summary 一行）
+      const lines = renderResult(result, { expanded: false }, renderTheme).render(400)
+      expect(lines.length).toBe(1)
+      expect(lines[0].trim()).toBe('Scheduled reminder in 5m')
+    }
+  })
+
   it('execute 是 async function', () => {
     const { pi, tools } = createMockPi()
     schedulerExtension(pi)

package/src/__tests__/summary.test.ts

@@ -47,6 +47,13 @@ describe('buildScheduleSummary', () => {
     const r = toolResult({ task: { name: 'Odd', schedule: { mode: 'bogus' } } })
     expect(buildScheduleSummary(createParams, r)).toBe('Scheduled "Odd" · 5m')
   })
+
+  it('name / schedule 含换行 → 摘要归一单行（S-1）', () => {
+    const r = toolResult({ task: { name: 'Multi\nline', schedule: { mode: 'bogus' } } })
+    expect(buildScheduleSummary({ ...createParams, schedule: '5m\nextra' }, r)).toBe(
+      'Scheduled "Multi line" · 5m extra',
+    )
+  })
 })
 
 // ── buildScheduleControlSummary ──────────────────────

package/src/format.ts

@@ -1,5 +1,5 @@
 // 时间格式化器（r4 M1 locale 版）：formatSchedule / formatRelativeTime 是 locale 必填的
-// 本地实现（UiLocale 双语输出，i18n.ts / widget / service / commands 消费）；fix 轨 locale
+// 本地实现（UiLocale 双语输出，i18n.ts / widget / service / commands 消费）；固定版 locale
 // 化与 U2 protocol 下沉（无 locale 面，服务 taiji plugin 管理侧）暂双轨并存，收敛待后续
 // 把 locale 版提升进 @zhushanwen/extension-protocol。formatDuration / MS_PER_* 单源
 // @zhushanwen/extension-protocol（re-export 保持既有 import 路径）。

package/src/index.ts

@@ -260,9 +260,6 @@ export default function schedulerExtension(pi: ExtensionAPI): void {
   pi.registerTool({
     name: 'schedule',
     label: 'Schedule',
-    // deferred（tool-declaration-slimming D4）：不常驻声明，tool_search 命中即激活；
-    // 迁移写入的 +tool_search 条目（runtime pi-codemode-settings）承载检索入口
-    exposure: 'deferred',
     description:
       'Create a scheduled task that fires a message at intervals or cron schedule. ' +
       'The task is created immediately (no confirmation form). It is a session-scoped reminder, ' +
@@ -295,8 +292,6 @@ export default function schedulerExtension(pi: ExtensionAPI): void {
   pi.registerTool({
     name: 'schedule_control',
     label: 'Schedule Control',
-    // deferred（tool-declaration-slimming D4）：同 schedule
-    exposure: 'deferred',
     description: 'Manage scheduled tasks: list, toggle, delete, or run immediately.',
     parameters: ScheduleControlParams,
     promptGuidelines: controlGuidelines,

package/src/render-result.ts

@@ -7,32 +7,7 @@
 
 import type { Theme } from '@earendil-works/pi-coding-agent'
 import { Text } from '@earendil-works/pi-tui'
-import { firstContentText } from '@zhushanwen/extension-protocol'
-
-/** content[0] 的 text 纯文本（content 缺失或非 text 类型时兜底空串）。 */
-function contentText(result: unknown): string {
-	const content = fieldValue(result, 'content')
-	if (!Array.isArray(content)) return ''
-	return firstContentText({ content })
-}
-
-/** unknown 值按字段名安全取值（index-signature 收窄，替代全可选结构断言）。 */
-function fieldValue(v: unknown, key: string): unknown {
-	if (typeof v !== 'object' || v === null) return undefined
-	return (v as Record<string, unknown>)[key]
-}
-
-/** 从 details 安全读取 summary（容错非对象形态与旧版本 entry）。 */
-function readDetailsSummary(result: unknown): string | undefined {
-	const summary = fieldValue(fieldValue(result, 'details'), 'summary')
-	return typeof summary === 'string' && summary !== '' ? summary : undefined
-}
-
-/** 折叠态回退：content 文本首行（保持一行摘要形态）。 */
-function firstLine(text: string): string {
-	const idx = text.indexOf('\n')
-	return idx === -1 ? text : text.slice(0, idx)
-}
+import { firstLine, readDetailsSummary, resultContentText } from '@zhushanwen/extension-protocol'
 
 /** 折叠态（expanded=false）= details.summary 一行（dim）；展开态 = content 纯文本。 */
 export function renderScheduleToolResult(
@@ -40,7 +15,7 @@ export function renderScheduleToolResult(
 	options: { expanded: boolean },
 	theme: Theme,
 ): Text {
-	if (options.expanded) return new Text(contentText(result), 0, 0)
-	const summary = readDetailsSummary(result) ?? firstLine(contentText(result))
+	if (options.expanded) return new Text(resultContentText(result), 0, 0)
+	const summary = readDetailsSummary(result) ?? firstLine(resultContentText(result))
 	return new Text(theme.fg('dim', summary), 0, 0)
 }

package/src/tool.ts

@@ -188,6 +188,13 @@ export function withScheduleSummary<T extends ToolResultLike>(
   return { ...result, details: { ...details, summary } }
 }
 
+/** 多行文本 → 单行摘要文本（换行与连续空白折叠为单空格；plan tool.ts 同模式）。
+ *  details.summary 单行契约见 docs/extensions/extension-conventions.md
+ *  「Tool result details.summary 约定」（自由文本 name/schedule 可含 \n，进摘要前先归一）。 */
+function toSingleLine(text: string): string {
+  return text.replace(/\s+/g, ' ').trim()
+}
+
 /** schedule（创建）摘要：`Scheduled "<name>" · <schedule>`；取消态与数据缺失时按形态降级。 */
 export function buildScheduleSummary(params: ScheduleParamsT, result: ToolResultLike): string {
   const details = asRecord(result.details)
@@ -197,8 +204,8 @@ export function buildScheduleSummary(params: ScheduleParamsT, result: ToolResult
   if (name === undefined) return 'Scheduled'
   const spec = asScheduleSpec(task.schedule)
   const kind = task.kind === 'once' || task.kind === 'recurring' ? (task.kind as TaskKind) : undefined
-  const scheduleText = spec !== undefined ? formatSchedule(spec, kind, 'en-US') : params.schedule
-  return `Scheduled "${name}" · ${scheduleText}`
+  const scheduleText = spec !== undefined ? formatSchedule(spec, kind, 'en-US') : toSingleLine(params.schedule)
+  return `Scheduled "${toSingleLine(name)}" · ${scheduleText}`
 }
 
 /** schedule_control 摘要：按 action 分支（toggle 按 enabled 目标态分 Paused/Resumed）。 */