dsh-deeppilot 0.9.13 → 0.9.15

package/lib/index.d.ts

@@ -1,10 +1,7 @@
 import z from "@deepseek-ai/schemastery";
 import { Context } from "@deepseek-ai/cordis";
-//#region src/device-auth.d.ts
 declare const DEVICE_SCOPES: readonly ['sessions.read', 'prompt.send', 'sessions.manage', 'interactions.respond', 'notifications.register', 'schedule.manage'];
 type DeviceScope = (typeof DEVICE_SCOPES)[number];
-//#endregion
-//#region src/wire-errors.d.ts
 /**
  * 错误词表（error vocabulary）的唯一属主。
  *
@@ -31,10 +28,9 @@ declare const ERROR_CODES: {
   readonly E_UNSUPPORTED: 'protocol version or capability unsupported';
   readonly E_INTERNAL: 'internal error';
   readonly E_STEER_UNAVAILABLE: 'queued item can no longer steer the current turn';
+  readonly E_TOO_LARGE: 'response exceeds the client frame limit';
 };
 type WireErrorCode = keyof typeof ERROR_CODES;
-//#endregion
-//#region src/dispatch-journal.d.ts
 /** 落盘条目：两个通用字段 + codec 私有字段。 */
 interface JournalEntry {
   fingerprint: string;
@@ -202,8 +198,6 @@ type MutationDispatchResult<T> = {
   message?: string;
   replayed?: boolean;
 };
-//#endregion
-//#region src/command-api.d.ts
 interface CommandSummary {
   name: string;
   description: string;
@@ -242,14 +236,119 @@ interface PermissionCatalog {
   options: PermissionOption[];
   currentValue?: string;
 }
-//#endregion
-//#region src/protocol.d.ts
 /**
  * `format` 缺省为 `zip`，与扩展出现前的行为逐字节相同；`markdown` 需要
  * `welcome.capabilities.sessionMarkdown`，否则 Bridge 回 E_UNSUPPORTED。
  * 不认识该字段的旧 Bridge 会忽略它并照常返回 ZIP，所以客户端必须先看能力位。
  */
 type SessionExportFormat = 'zip' | 'markdown';
+/** `at` 的本地日历写法；与 DSH `LocalAtInput` 一一对应。 */
+interface HostScheduleLocalAt {
+  date: string;
+  time: string;
+  time_zone: string;
+}
+type HostScheduleTiming = {
+  kind: 'after';
+  after_seconds: number;
+} | {
+  kind: 'at';
+  at: string | HostScheduleLocalAt;
+} | {
+  kind: 'every';
+  every_seconds: number;
+} | {
+  kind: 'daily';
+  daily: {
+    time: string;
+    time_zone: string;
+  };
+} | {
+  kind: 'weekly';
+  weekly: {
+    time: string;
+    time_zone: string;
+    weekdays: number[];
+  };
+} | {
+  kind: 'cron';
+  cron: {
+    expression: string;
+    time_zone: string;
+  };
+} | {
+  kind: 'rrule';
+  rrule: string;
+};
+/** `new_once` / `new` 目标建会话时的工作目录与预设（省略用 Host 默认）。 */
+interface HostScheduleCreateSpec {
+  cwd?: string;
+  agentPreset?: string;
+}
+/**
+ * 任务视图里的交付目标。`new_once` 的 `sessionId` 是 Host 创建时预留的会话，
+ * 首次投递后目标会转成 `session`。
+ */
+type HostScheduleTarget = {
+  kind: 'session';
+  sessionId: string;
+} | {
+  kind: 'new_once';
+  sessionId: string;
+  create?: HostScheduleCreateSpec;
+} | {
+  kind: 'new';
+  create?: HostScheduleCreateSpec;
+};
+/**
+ * 创建/编辑请求里客户端可给出的目标：`new_once` 的会话由 Host 预留，客户端不填
+ * `sessionId`。
+ */
+type HostScheduleTargetRequest = {
+  kind: 'session';
+  sessionId: string;
+} | {
+  kind: 'new_once';
+  create?: HostScheduleCreateSpec;
+} | {
+  kind: 'new';
+  create?: HostScheduleCreateSpec;
+};
+/** 最近一次已确认投递的回执；不含 prompt 正文。 */
+interface HostScheduleDeliveryReceipt {
+  scheduledAt: string;
+  deliveredAt: string;
+  messageId: string;
+  targetSessionId: string;
+}
+/**
+ * 宿主级任务视图。可选字段（createdAt/updatedAt/executionActive/
+ * deliveryFloorEndsAt/lastDelivery）客户端不得依赖；`involvedSessionIds` 是
+ * Host 内部字段，Bridge 不返回。
+ */
+interface HostScheduleTask {
+  id: string;
+  title: string;
+  prompt: string;
+  timing: HostScheduleTiming;
+  target: HostScheduleTarget;
+  status: 'active' | 'paused' | 'ended';
+  scheduledAt: string;
+  createdAt?: string;
+  updatedAt?: string;
+  executionActive?: boolean;
+  deliveryFloorEndsAt?: string;
+  lastDelivery?: HostScheduleDeliveryReceipt;
+}
+/** 编辑补丁：至少一个字段；省略的字段保持原值。 */
+interface HostSchedulePatch {
+  title?: string;
+  prompt?: string;
+  timing?: HostScheduleTiming;
+  target?: HostScheduleTargetRequest;
+  /** false 暂停、true 恢复。 */
+  active?: boolean;
+}
 interface WelcomeCapabilities {
   /** 会话命令目录、执行、权限与原生日志导出入口。缺省不支持。 */
   commands?: boolean;
@@ -275,6 +374,10 @@ interface WelcomeCapabilities {
   projectSelection: boolean;
   /** Host exposes the optional DSH Schedule service. */
   schedules?: boolean;
+  /** 宿主级计划任务模型（DSH 0.2.2-alpha.3 起）：true 时
+   * 「Schedule 宿主级任务扩展」帧可用，schedulesHost=false/缺失时客户端只能
+   * 使用会话级 schedule 帧。与 `schedules` 相互独立（后者只表示服务存在）。 */
+  schedulesHost?: boolean;
   /** Bridge has APNs configured; clients may send c2s.push.register. */
   push?: boolean;
   widgetPush?: boolean;
@@ -298,6 +401,11 @@ interface WelcomeCapabilities {
    * the phone replace this plugin with a published version. Absent ⇒ the phone
    * can only link out to npm. */
   pluginUpdate?: boolean;
+  /** Bridge answers c2s.session.export / c2s.session.attachment requests that
+   * carry `binary: true` with binary frames (raw bytes after a JSON header,
+   * see binary-frame.ts). Plugin-level, independent of the host. Absent ⇒ the
+   * client must keep requesting base64 text frames. */
+  binaryFrames?: boolean;
 }
 type SessionStatus = "running" | "idle" | "error" | "unknown";
 /**
@@ -370,6 +478,21 @@ interface SessionSummary {
 }
 type MessageRole = 'user' | 'assistant' | 'tool' | 'system' | 'error';
 type ToolState = 'running' | 'ok' | 'error';
+/**
+ * 文件编辑类工具调用的改动内容（v2 追加式扩展，见 PROTOCOL.md「工具改动对比」）。
+ * Bridge 把宿主 `str_replace_editor` 的参数名（old_str/new_str/file_text/insert_line）
+ * 归一化成这里的字段，手机端不依赖宿主工具参数命名。`oldText` / `newText` 各自超过
+ * 16 KiB（UTF-8）时都不发，只带 `truncated: true`。
+ */
+interface ToolEditProjection {
+  path: string;
+  operation: 'replace' | 'create' | 'insert';
+  oldText?: string;
+  newText?: string;
+  /** `insert` 专用：在该行之后插入，0 表示文件开头。 */
+  insertLine?: number;
+  truncated?: boolean;
+}
 /** Provenance of host-injected context; present only on `role: "system"` rows.
  * Mirrors the durable DSH message source (`dsh-llm` MessageSource): `label`
  * names the producer (plugin name, skill name, instruction paths…), `form` is
@@ -403,6 +526,7 @@ interface MessageProjection {
     name: string;
     state: ToolState;
     summary: string;
+    edit?: ToolEditProjection;
   };
   attachments?: MessageAttachment[];
   /** Present only on system rows: provenance of the injected context.
@@ -464,8 +588,6 @@ interface PendingSnapshotPayload {
   approvals: PendingApprovalPayload[];
   questions: PendingQuestionPayload[];
 }
-//#endregion
-//#region src/host-api.d.ts
 interface CommandsApiLike {
   list(req: RpcRequestLike<{
     sessionId: string;
@@ -640,7 +762,10 @@ interface ScheduleHistoryViewLike {
   };
   nextBefore?: string;
 }
-interface ScheduleApiLike {
+/** 会话级 Schedule 服务（DSH ≤ 0.2.2-alpha.2）：任务绑定单一 Session。 */
+interface LegacyScheduleApiLike {
+  /** 判别位缺省即 legacy：旧宿主与既有测试夹具不必补字段。 */
+  readonly mode?: 'legacy';
   list(req: RpcRequestLike<{
     sessionId: string;
   }>): Promise<RpcResponseLike<{
@@ -684,6 +809,107 @@ interface ScheduleApiLike {
     code?: string;
   }>>;
 }
+/** 宿主级任务视图：与 wire 的 `HostScheduleTask` 同一形状（Bridge 直接透传）。 */
+type HostScheduleTaskView = HostScheduleTask;
+interface HostScheduleListRequestLike {
+  /** true 只列运行中；false 只列暂停/结束；省略列全部。 */
+  active?: boolean;
+  limit?: number;
+  offset?: number;
+}
+interface HostScheduleListResultLike {
+  tasks: HostScheduleTaskView[];
+  shown: number;
+  total: number;
+  limit: number;
+  offset: number;
+}
+/** 查看结果：命中或非变更 miss（Host 用 code 表示 miss，不是抛错）。 */
+type HostScheduleViewOutcome = {
+  kind: 'task';
+  task: HostScheduleTaskView;
+} | {
+  kind: 'not-found';
+  id: string;
+};
+/** 编辑结果：更新后的任务、已删除、miss，或乐观锁冲突（wire 上回 E_BUSY）。 */
+type HostScheduleEditOutcome = {
+  kind: 'task';
+  task: HostScheduleTaskView;
+} | {
+  kind: 'deleted';
+  id: string;
+} | {
+  kind: 'not-found';
+  id: string;
+} | {
+  kind: 'conflict';
+  id: string;
+};
+/** 手动执行结果：已投递、已有执行在进行中（E_BUSY），或目标已不存在。 */
+type HostScheduleRunOutcome = {
+  kind: 'task';
+  task: HostScheduleTaskView;
+} | {
+  kind: 'pending';
+  id: string;
+} | {
+  kind: 'not-found';
+  id: string;
+};
+/** 清理已结束任务的结果：删除的条数（宿主上没有已结束任务时为 0）。 */
+interface HostScheduleDeleteEndedResult {
+  deleted: number;
+}
+interface HostScheduleLimitsView {
+  /** 以新建会话方式投递的最小间隔秒数；客户端只展示，不自行节流。 */
+  newSessionIntervalSeconds: number;
+}
+interface HostScheduleCreateRequestLike {
+  title: string;
+  prompt: string;
+  timing: HostScheduleTiming;
+  /** 省略时由 Host 默认：首次投递新建并复用会话。 */
+  target?: HostScheduleTargetRequest;
+}
+type HostScheduleEditRequestLike = {
+  id: string;
+  action: 'update';
+  patch: HostSchedulePatch;
+  expectedUpdatedAt?: string | null;
+} | {
+  id: string;
+  action: 'delete';
+  expectedUpdatedAt?: string | null;
+};
+/**
+ * 宿主级 Schedule 服务（DSH 0.2.2-alpha.3 起）。
+ *
+ * 探测只看形状：`edit` 存在且 `update` 不存在。`remoteXxx` 是同一服务的
+ * 「人类 Remote 调用」变体（不记录 acting Session）；Bridge 就是人类 Remote
+ * 调用方，因此直接用公开方法并省略 actorSessionId。
+ */
+interface HostScheduleApiLike {
+  readonly mode: 'host';
+  list(req: RpcRequestLike<HostScheduleListRequestLike>): Promise<RpcResponseLike<HostScheduleListResultLike>>;
+  view(req: RpcRequestLike<{
+    id: string;
+  }>): Promise<RpcResponseLike<HostScheduleViewOutcome>>;
+  create(req: RpcRequestLike<HostScheduleCreateRequestLike>): Promise<RpcResponseLike<HostScheduleTaskView>>;
+  edit(req: RpcRequestLike<HostScheduleEditRequestLike>): Promise<RpcResponseLike<HostScheduleEditOutcome>>;
+  run(req: RpcRequestLike<{
+    id: string;
+  }>): Promise<RpcResponseLike<HostScheduleRunOutcome>>;
+  history(req: RpcRequestLike<{
+    id: string;
+    limit: number;
+    before?: string;
+  }>): Promise<RpcResponseLike<ScheduleHistoryViewLike>>;
+  limits(req: RpcRequestLike<Record<string, never>>): Promise<RpcResponseLike<HostScheduleLimitsView>>;
+  /** 删除宿主上全部 `status="ended"` 的任务；进行中与暂停的任务不受影响。 */
+  deleteEnded(req: RpcRequestLike<Record<string, never>>): Promise<RpcResponseLike<HostScheduleDeleteEndedResult>>;
+}
+type ScheduleApiLike = LegacyScheduleApiLike | HostScheduleApiLike;
 interface HostApiLike {
   listDirectory?(req: RpcRequestLike<{
     path?: string;
@@ -914,16 +1140,48 @@ interface PushOutlet {
    */
   isAvailable(): boolean;
 }
-//#endregion
-//#region src/document-payload.d.ts
+interface QuietCompletionResult {
+  suppressed: boolean;
+  note?: string;
+}
+interface TurnVerdict {
+  /** 本轮最近一条驱动消息是计划任务投递（且其后没有用户消息）。 */
+  scheduled: boolean;
+  /** 本轮 `turn/start` 的轮次号；日志里读不到时为 undefined。 */
+  turn?: number;
+}
+declare class QuietCompletionTracker {
+  /**
+   * 判定过计划任务轮次的会话。粘性集合：加入后不再移除，工具不按轮出现或消失。
+   * 宿主每次工具列表变化都会往会话追加一条工具增减消息并让提示词缓存失效，
+   * 按轮开关会让同一会话反复产生这类消息。
+   */
+  private readonly scheduleSessions;
+  private readonly quiet;
+  /** 启动时用宿主任务列表里的投递目标会话预热，避免重启后工具先消失再出现。 */
+  seed(sessionIds: Iterable<string>): void;
+  isScheduleSession(sessionId: string): boolean;
+  /** 加入粘性集合；返回是否为新加入（调用方据此记一次日志）。 */
+  markScheduleSession(sessionId: string): boolean;
+  /** 工具执行：只在计划任务轮次内生效。 */
+  requestQuiet(sessionId: string | undefined, verdict: TurnVerdict, seq: number): QuietCompletionResult;
+  /**
+   * 桥接层观察到 user/message：用户在请求静默之后插话（日志位置更晚）就撤销静默，
+   * 本轮照常提醒。计划任务与注入上下文不影响。
+   */
+  noteUserMessage(sessionId: string, sourceKind: string | undefined, seq: number | undefined): void;
+  /**
+   * turn.end 时调用。返回 true 表示本轮完成通知应被抑制：成功结束、且本轮请求过静默。
+   * 轮次号能对上时按轮次号判定；迟到的上一轮 turn.end 保留本轮的请求。
+   */
+  consumeTurnEnd(sessionId: string, ok: boolean, turn: number | undefined, seq: number | undefined): boolean;
+}
 interface PromptDocument {
   name: string;
   mediaType: string;
   text: string;
   truncated?: boolean;
 }
-//#endregion
-//#region src/host-bridge.d.ts
 /**
  * 失败结果直接携带 wire 错误码（error vocabulary 见 wire-errors.ts）。
  *
@@ -942,7 +1200,19 @@ type ScheduleBridgeResult<T> = {
   message: string;
   replayed?: boolean;
 };
-declare class HostBridge {
+/**
+ * 宿主级编辑（update / delete 合一的 `edit`）的 Bridge 结果值。
+ *
+ * 与 legacy 的 updated/deleted 两个独立帧结果分开表达，wire handler 用
+ * `'deleted' in value` 落成 `deleted:true` 或 `task`。
+ */
+type HostScheduleEditValue = {
+  task: HostScheduleTaskView;
+} | {
+  deleted: true;
+  id: string;
+};
+export declare class HostBridge {
   private readonly apiProxy;
   private readonly historyBufferMax;
   /** 三个 journal 的落盘失败诊断输出；缺省即静默。不打任何消息体。 */
@@ -957,6 +1227,8 @@ declare class HostBridge {
    * and restore them. Excluded from `summaries` and from the live broadcast. */
   private archivedSummaries;
   private subagentSessionIds;
+  /** 计划任务按需完成通知（quiet-completion.ts）：index.ts 用它注册 Agent 工具。 */
+  readonly quietCompletion: QuietCompletionTracker;
   /**
    * 每个会话最近一次已知的队列（inbox 投影的折叠结果）及其指纹。来源是实时
    * 投影通知或打开会话时读到的基线；指纹用来丢掉内容没变的重复通知。
@@ -1040,6 +1312,13 @@ declare class HostBridge {
   private record;
   /** Start consuming host + mux streams. Idempotent; aborts on dispose(). */
   start(): void;
+  /**
+   * 用宿主任务列表里的投递目标会话预热计划任务会话集合，避免插件重启后工具
+   * 先消失、等下一次投递再出现（每次变化都会给会话追加工具增减消息）。
+   * `new` 目标没有固定会话，只能从最近一次投递回执里取。失败只记日志：集合仍会
+   * 在下一次投递时补上。由 index.ts 在 schedule 服务就绪、注册工具时调用。
+   */
+  seedQuietCompletionSessions(): Promise<void>;
   dispose(): void;
   private runHostStream;
   private runMuxStream;
@@ -1149,7 +1428,52 @@ declare class HostBridge {
   }): Promise<ScheduleBridgeResult<{
     sessionId: string;
   }>>;
+  /**
+   * 当前 adapter 是否宿主级计划任务模型。
+   *
+   * 能力位 `schedulesHost`（host-capabilities.ts）与新帧、旧帧映射全部读这一个
+   * 判别位：探测只发生一次（DshApiProxy.resolveSchedule），这里不再看控制器
+   * 方法，也不看版本号字符串。
+   */
+  private get hostSchedule();
   listSchedules(sessionId: string): Promise<ScheduleBridgeResult<ScheduleTaskViewLike[]>>;
+  /** 宿主级列表 -> 旧会话级视图：过滤 session 目标、丢弃 ended、按 scheduledAt 升序。 */
+  private listHostSchedulesAsLegacy;
+  listHostSchedules(request?: HostScheduleListRequestLike): Promise<ScheduleBridgeResult<HostScheduleListResultLike>>;
+  viewHostSchedule(id: string): Promise<ScheduleBridgeResult<HostScheduleTaskView>>;
+  createHostSchedule(deviceId: string, payload: Record<string, unknown> & {
+    clientRequestId: string;
+    title: string;
+    prompt: string;
+    timing: unknown;
+    target?: unknown;
+  }): Promise<ScheduleBridgeResult<HostScheduleTaskView>>;
+  editHostSchedule(deviceId: string, payload: Record<string, unknown> & {
+    clientRequestId: string;
+    id: string;
+    action: 'update' | 'delete';
+    expectedUpdatedAt?: string | null;
+    patch?: unknown;
+  }): Promise<ScheduleBridgeResult<HostScheduleEditValue>>;
+  runHostSchedule(deviceId: string, payload: {
+    clientRequestId: string;
+    id: string;
+  }): Promise<ScheduleBridgeResult<HostScheduleTaskView>>;
+  /**
+   * 删除宿主上全部已结束（`status="ended"`）的任务，返回删除条数。
+   *
+   * 与其他变更帧共用 scheduleMutations journal：同一 clientRequestId 重放时直接回放
+   * 首次结果，不会再删一次。成功后广播 `s2c.schedule.changed`；失败时同样广播——上游
+   * 文档说明失败的批次无法确定哪些行已删除，客户端应重新读取列表。
+   */
+  deleteEndedHostSchedules(deviceId: string, payload: {
+    clientRequestId: string;
+  }): Promise<ScheduleBridgeResult<{
+    deleted?: number;
+  }>>;
+  scheduleLimits(): Promise<ScheduleBridgeResult<{
+    newSessionIntervalSeconds: number;
+  }>>;
   scheduleHistory(sessionId: string, id: string, limit: number, before?: string): Promise<ScheduleBridgeResult<ScheduleHistoryViewLike>>;
   createSchedule(deviceId: string, payload: Record<string, unknown> & {
     sessionId: string;
@@ -1182,9 +1506,7 @@ declare class HostBridge {
   respondApproval(requestId: string, decision: 'allow' | 'deny', reason?: string): Promise<PendingResponseOutcome>;
   respondQuestion(requestId: string, answers: unknown): Promise<PendingResponseOutcome>;
 }
-//#endregion
-//#region src/config.d.ts
-interface Config {
+export interface Config {
   /** Master switch; when false the plugin activates and does nothing. */
   enabled?: boolean;
   /** Protocol-v2 device registry JSON path. */
@@ -1237,7 +1559,7 @@ interface Config {
     relayToken?: string;
   };
 }
-declare const Config: z<Schemastery.ObjectS<NoInfer<{
+export declare const Config: z<Schemastery.ObjectS<NoInfer<{
   enabled: z<boolean, boolean, "volatile-defined">;
   devicesPath: z<string, string, "defined">;
   historyBufferMax: z<number, number, "defined">;
@@ -1342,12 +1664,10 @@ declare const Config: z<Schemastery.ObjectS<NoInfer<{
     relayToken: z<string, string, "defined">;
   }>>, "defined">;
 }>>, "plain">;
-//#endregion
-//#region src/push-policy.d.ts
 /** Prune only when the provider supplies an authoritative token-lifecycle verdict. */
-declare function shouldPrunePushToken(outcome: 'sent' | 'invalid-token' | 'failed', reason?: string): boolean;
+export declare function shouldPrunePushToken(outcome: 'sent' | 'invalid-token' | 'failed', reason?: string): boolean;
 /** APNs requires both registration and the same content permission as WS. */
-declare function mayReceivePush(device: {
+export declare function mayReceivePush(device: {
   scopes?: readonly string[];
 }, notification: unknown): boolean;
 /**
@@ -1356,13 +1676,11 @@ declare function mayReceivePush(device: {
  * re-derive it; an explicitly configured relay token remains user-owned
  * configuration and is never silently rewritten.
  */
-declare function shouldReEnrollRelayToken(transport: 'apns' | 'relay', outcome: 'sent' | 'invalid-token' | 'failed', reason: string | undefined, opts: {
+export declare function shouldReEnrollRelayToken(transport: 'apns' | 'relay', outcome: 'sent' | 'invalid-token' | 'failed', reason: string | undefined, opts: {
   usedCellToken: boolean;
   hasEnrollKey: boolean;
   tokenStillCurrent: boolean;
 }): boolean;
-//#endregion
-//#region src/index.d.ts
 /**
  * dsh-deeppilot — data bridge between the DSH host and DeepPilot
  * clients. Owns independent, narrowly routed LAN (TLS-only, pinned by paired
@@ -1377,10 +1695,9 @@ declare function shouldReEnrollRelayToken(transport: 'apns' | 'relay', outcome:
  * Protocol: PROTOCOL.md is normative; src/protocol.ts and the private app's
  * Swift models mirror that v2 contract.
  */
-declare const name = "deeppilot";
+export declare const name = "deeppilot";
 /** No web-service requirement: the plugin owns its own transport listeners. */
-declare const inject: string[];
-declare function apply(ctx: Context, options: unknown): void;
-//#endregion
-export { Config, HostBridge, apply, inject, mayReceivePush, name, shouldPrunePushToken, shouldReEnrollRelayToken };
+export declare const inject: string[];
+export declare function apply(ctx: Context, options: unknown): void;
+export {};
 //# sourceMappingURL=index.d.ts.map