dsh-deeppilot 0.9.9 → 0.9.13

package/lib/index.d.ts

@@ -30,6 +30,7 @@ declare const ERROR_CODES: {
   readonly E_BUSY: 'session is busy';
   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';
 };
 type WireErrorCode = keyof typeof ERROR_CODES;
 //#endregion
@@ -243,6 +244,12 @@ interface PermissionCatalog {
 }
 //#endregion
 //#region src/protocol.d.ts
+/**
+ * `format` 缺省为 `zip`，与扩展出现前的行为逐字节相同；`markdown` 需要
+ * `welcome.capabilities.sessionMarkdown`，否则 Bridge 回 E_UNSUPPORTED。
+ * 不认识该字段的旧 Bridge 会忽略它并照常返回 ZIP，所以客户端必须先看能力位。
+ */
+type SessionExportFormat = 'zip' | 'markdown';
 interface WelcomeCapabilities {
   /** 会话命令目录、执行、权限与原生日志导出入口。缺省不支持。 */
   commands?: boolean;
@@ -276,6 +283,21 @@ interface WelcomeCapabilities {
    * deleting its local credentials. Absent on older bridges; older clients
    * ignore the extra field. */
   deviceRevoke?: boolean;
+  /** Host exposes DSH session.updateQueue and the inbox projection: running
+   * sessions accept mode:"steer", s2c.session.queue snapshots are pushed and
+   * c2s.session.queue.update is served. Absent ⇒ running sessions only stop. */
+  promptQueue?: boolean;
+  /** Bridge pushes s2c.session.delta while a turn runs: transient assistant and
+   * reasoning increments that never occupy a replay seq. Absent ⇒ the client
+   * keeps the old "text appears when the step lands" rendering. */
+  assistantStream?: boolean;
+  /** Bridge serves c2s.session.export with format:"markdown" (the host's
+   * /api/session.markdown route). Absent ⇒ only the ZIP archive is available. */
+  sessionMarkdown?: boolean;
+  /** Bridge serves c2s.plugin.update.check / c2s.plugin.update.apply, letting
+   * the phone replace this plugin with a published version. Absent ⇒ the phone
+   * can only link out to npm. */
+  pluginUpdate?: boolean;
 }
 type SessionStatus = "running" | "idle" | "error" | "unknown";
 /**
@@ -462,8 +484,10 @@ interface CommandsApiLike {
     text: string;
     category?: string;
   }>): Promise<RpcResponseLike<void>>;
+  readonly markdownAvailable?: boolean;
   export(req: RpcRequestLike<{
     sessionId: string;
+    format?: SessionExportFormat;
   }>, signal: AbortSignal): Promise<Response>;
 }
 interface RpcOk<T> {
@@ -549,6 +573,11 @@ interface SessionsApiLike {
     };
     data: string;
   }>>;
+  /** Remove or steer one pending inbox item. Absent on hosts without the
+   * DSH session.updateQueue RPC; the promptQueue capability bit probes it. */
+  updateQueue?(req: RpcRequestLike<QueueUpdateArgs>): Promise<RpcResponseLike<{
+    accepted: true;
+  }>>;
   /** Complete projection baseline for one session; null when it is gone. */
   projections(req: RpcRequestLike<{
     sessionId: string;
@@ -749,6 +778,16 @@ interface PromptArgs {
   }>;
   clientTimeZone?: string;
 }
+/** DSH session.updateQueue request; `edit` is reserved on the wire and never sent. */
+interface QueueUpdateArgs {
+  sessionId: string;
+  itemId: string;
+  action: {
+    kind: 'remove';
+  } | {
+    kind: 'steer';
+  };
+}
 interface PhoneSessionRow {
   sessionId: string;
   updatedAt: number;
@@ -809,6 +848,8 @@ interface ApiStreamItemLike {
   payload: MuxFrameLike;
 }
 interface ApiProxyLike {
+  /** 真实宿主反射声明了助手流帧时才为 true；旧代理缺省关闭。 */
+  readonly assistantStreamAvailable?: boolean;
   commands?: CommandsApiLike;
   sessions: SessionsApiLike;
   workspace?: WorkspaceApiLike;
@@ -916,7 +957,13 @@ declare class HostBridge {
    * and restore them. Excluded from `summaries` and from the live broadcast. */
   private archivedSummaries;
   private subagentSessionIds;
+  /**
+   * 每个会话最近一次已知的队列（inbox 投影的折叠结果）及其指纹。来源是实时
+   * 投影通知或打开会话时读到的基线；指纹用来丢掉内容没变的重复通知。
+   */
+  private queues;
   private sinks;
+  private readonly assistantStream;
   private ring;
   private cursor;
   private userReceiptSeq;
@@ -957,6 +1004,9 @@ declare class HostBridge {
   markSinkOpen(sink: BridgeSink, sessionId: string): void;
   markSinkClosed(sink: BridgeSink, sessionId: string): void;
   dropSinkSessions(sink: BridgeSink): void;
+  private hasStreamViewer;
+  /** Instant publications bypass record(): no cursor, ring, notification or push side effect. */
+  private pushAssistantDelta;
   private isViewedBy;
   /** F-9: when a notification-worthy event fires, mirror it to every
    *  online device that is not currently viewing the session (the s2c.notify
@@ -971,7 +1021,11 @@ declare class HostBridge {
    * push failures must never block or break the WS data plane.
    */
   private fanOutPush;
-  /** Remember the latest assistant text so notifications can quote it. */
+  /**
+   * Remember the latest assistant text so notifications can quote it. 存完整原文：
+   * 按字符数截尾会从链接地址中间切开（横幅只剩 URL 编码的路径），段落选择与
+   * Markdown 清洗统一留到 emitNotify。条目随 sessions.list / 归档清理。
+   */
   private captureAssistantText;
   /**
    * Replay buffered pushes after the given cursor; false when the gap is
@@ -996,6 +1050,19 @@ declare class HostBridge {
   private deriveTitleFallback;
   private captureActivity;
   private noteActivity;
+  /**
+   * 折叠一次 inbox 投影。只有实时变化才广播 s2c.session.queue；基线只补缓存，
+   * 打开会话的那台设备另由 pushQueueSnapshot 点对点拿到快照。
+   *
+   * 基线只补缺不覆盖：实时通知带的是完整投影值，收到过就以它为准；基线读取与
+   * 实时变化并发时，较早算出的基线不得盖掉较新的实时值。
+   */
+  private applyInbox;
+  /**
+   * 打开会话时补发的快照：不占 seq，与 tail 同属打开响应。还没读到过该会话的
+   * 投影（基线失败、Host 不提供或子代理会话）时不发，因为未知不等于空队列。
+   */
+  private pushQueueSnapshot;
   private applyProjection;
   private bumpPendingFlags;
   private pushSummary;
@@ -1034,7 +1101,7 @@ declare class HostBridge {
     data: string;
   } | null>;
   commandOperation(operation: 'list' | 'execute' | 'permissions' | 'feedback', payload: Record<string, unknown>): Promise<SessionManagementResult<unknown>>;
-  exportSession(sessionId: string, signal: AbortSignal): Promise<Response>;
+  exportSession(sessionId: string, signal: AbortSignal, format?: SessionExportFormat): Promise<Response>;
   /** 由会话目录决定技能可见性；不读取正文，也不把本机路径发给移动端。 */
   sessionSkills(sessionId: string): Promise<SessionManagementResult<{
     skills: SkillSummary[];
@@ -1044,6 +1111,14 @@ declare class HostBridge {
   renameSession(sessionId: string, title: string): Promise<SessionManagementResult<string>>;
   archiveSession(sessionId: string): Promise<SessionManagementResult<true>>;
   unarchiveSession(sessionId: string): Promise<SessionManagementResult<true>>;
+  /**
+   * 删除或转向一条排队项。ack 只表示 Host 已提交变更，真实状态以随后的
+   * s2c.session.queue 为准；不做幂等，项已消失时 Host 回 queue-item-not-found。
+   */
+  updateQueue(sessionId: string, itemId: string, action: 'remove' | 'steer'): Promise<SessionManagementResult<{
+    sessionId: string;
+    itemId: string;
+  }>>;
   cancelSession(sessionId: string): Promise<SessionManagementResult<true>>;
   listWorkspaces(): Promise<SessionManagementResult<Array<{
     id: string;
@@ -1100,7 +1175,10 @@ declare class HostBridge {
     mediaType: 'image/png' | 'image/jpeg' | 'image/webp' | 'image/gif';
     data: string;
     name?: string;
-  }>, documents?: PromptDocument[]): Promise<SessionManagementResult<number>>;
+  }>, documents?: PromptDocument[], options?: {
+    mode?: 'queue' | 'steer';
+    clientSendId?: string;
+  }): Promise<SessionManagementResult<number>>;
   respondApproval(requestId: string, decision: 'allow' | 'deny', reason?: string): Promise<PendingResponseOutcome>;
   respondQuestion(requestId: string, answers: unknown): Promise<PendingResponseOutcome>;
 }