lark-remote 0.4.3 → 0.4.5

package/dist/bridge/queue-manager.d.ts

@@ -7,6 +7,13 @@ import type { AgentKind } from '../runner/types.js';
 export interface AgentBinding {
     agent: AgentKind;
     sessionId?: string;
+    /**
+     * 会话代际快照（与 sessionId 同刻捕获）。随 binding 带到执行时刻：若执行前
+     * session 指针被移动（/new、/cd、/resume、/config 切换），该 run 的 init /
+     * turn_started 写回判 stale 跳过，避免「先发消息 → 后点新会话」时旧 sessionId
+     * 被写回复活（2026-10-07 事故）。缺省时回退到执行起点捕获，保持旧行为。
+     */
+    sessionEpoch?: number;
 }
 /** A queued task with its metadata for queue display cards. */
 export interface QueuedTask {
@@ -26,7 +33,7 @@ export interface QueuedTask {
      * to `messageId` for hand-typed messages, where the two coincide.
      */
     feishuReplyTo?: string;
-    workspace: string;
+    cwd: string;
     timestamp: number;
     messagePreview: string;
     /**
@@ -67,7 +74,7 @@ export interface EnqueueOptions {
         binding?: AgentBinding;
     };
 }
-/** Queue info for a workspace */
+/** Queue info for a cwd */
 interface QueueInfo {
     position: number;
     tasksAhead: number;
@@ -89,7 +96,7 @@ export declare class QueueManager {
      * `updateQueuedTaskMessage`. The ordered array remains the source of truth
      * (position display depends on order); the index must be kept in sync on
      * every mutation (push / splice / shift) via the `indexAdd`/`indexRemove`
-     * helpers. Same messageId is never enqueued twice in one workspace
+     * helpers. Same messageId is never enqueued twice in one cwd
      * (Feishu dedup + internal-key dedup), so no overwrite concern.
      */
     private taskIndex;
@@ -103,7 +110,7 @@ export declare class QueueManager {
      */
     /** queue card 的 send promise 表（public：bridge 集成测试注入/断言用）。 */
     queueCardMessages: Map<string, Promise<string | undefined>>;
-    /** Track number of executing tasks per workspace (for queue card display). */
+    /** Track number of executing tasks per cwd (for queue card display). */
     private pendingOrExecutingCount;
     /**
      * Monotonic counter minting a unique slot id per enqueued task. A slot
@@ -146,13 +153,13 @@ export declare class QueueManager {
      * before begin); `removeFromQueue` therefore needs no cleanup here.
      */
     private beganMessageIds;
-    /** Callback to check if workspace has an active run */
+    /** Callback to check if cwd has an active run */
     private isWorkspaceRunning;
     /** Callback to send card updates */
     private sendCard;
     /** Callback to update existing card */
     private updateCard;
-    constructor(isWorkspaceRunning: (workspace: string) => boolean, sendCard: (chatId: string, card: object, opts?: {
+    constructor(isWorkspaceRunning: (cwd: string) => boolean, sendCard: (chatId: string, card: object, opts?: {
         replyTo?: string;
     }) => Promise<string>, updateCard: (messageId: string, card: object) => Promise<void>);
     /** P3-5: register a queued task in the per-workspace `messageId → task` index. */
@@ -163,31 +170,31 @@ export declare class QueueManager {
     private indexGet;
     /**
      * Enqueue a task into the workspace-level serial queue.
-     * Each workspace has its own serial queue for parallel execution across workspaces.
+     * Each cwd has its own serial queue for parallel execution across workspaces.
      */
-    enqueue(workspace: string, task: () => Promise<void>, opts?: EnqueueOptions): void;
+    enqueue(cwd: string, task: () => Promise<void>, opts?: EnqueueOptions): void;
     /**
      * Execute a task immediately without going through the queue.
      * Used for / commands that should respond immediately.
      */
-    enqueueImmediate(workspace: string, task: () => Promise<void>): void;
+    enqueueImmediate(cwd: string, task: () => Promise<void>): void;
     /**
      * One-shot: replace the execution closure of an existing queued task in
      * place, preserving its queue position (tasks queued behind it still run
      * after it). Consumed when the task's slot begins; removed if cancelled.
      */
-    setTaskReplacement(workspace: string, messageId: string, task: () => Promise<void>): void;
+    setTaskReplacement(cwd: string, messageId: string, task: () => Promise<void>): void;
     /** Send a queue status card showing current queue position and actions. */
     private sendQueueStatusCard;
-    /** Get queue info for a workspace. */
-    getQueueInfo(workspace: string): QueueInfo;
+    /** Get queue info for a cwd. */
+    getQueueInfo(cwd: string): QueueInfo;
     /** Build queue status card elements. */
     private buildQueueStatusCardElements;
     /**
      * Build the 撤销/立即执行 action button pair for a queue card.
      *
      * Both buttons route to `queue.cancel` / `queue.immediate` callbacks with
-     * the same workspace/messageId; only the `disabled` flag varies by card
+     * the same cwd/messageId; only the `disabled` flag varies by card
      * state — pending cards enable both, executing/cancelled cards disable
      * both. Centralizing the pair here eliminates the 3-way duplication
      * between `buildQueueStatusCardElements`, `updateQueueCardToExecuting`,
@@ -205,13 +212,13 @@ export declare class QueueManager {
      * the card must keep its "❌ 已撤销" state instead of being flipped back to
      * executing. The mapping is deleted in finally in both cases.
      */
-    updateQueueCardToExecuting(workspace: string, messageId: string, messagePreview: string, started?: boolean): Promise<void>;
+    updateQueueCardToExecuting(cwd: string, messageId: string, messagePreview: string, started?: boolean): Promise<void>;
     /** Remove a task from the queue by messageId. Returns true if found and removed. */
-    removeFromQueue(workspace: string, messageId: string): boolean;
+    removeFromQueue(cwd: string, messageId: string): boolean;
     /** Update queue card to "cancelled" status when user clicks 撤销. */
-    updateQueueCardToCancelled(workspace: string, messageId: string): Promise<void>;
+    updateQueueCardToCancelled(cwd: string, messageId: string): Promise<void>;
     /** Get task metadata from queue. */
-    getQueuedTask(workspace: string, messageId: string): QueuedTask | undefined;
+    getQueuedTask(cwd: string, messageId: string): QueuedTask | undefined;
     /**
      * Whether a task with the given messageId has begun executing (cancellation
      * check passed, task removed from the queue). Sticky: true even after the
@@ -219,10 +226,10 @@ export declare class QueueManager {
      * completed)" from "never began / cancelled".
      */
     hasBegan(messageId: string): boolean;
-    /** Get all queued tasks for a workspace. Returns a copy to prevent aliasing bugs. */
-    getQueuedTasks(workspace: string): QueuedTask[];
+    /** Get all queued tasks for a cwd. Returns a copy to prevent aliasing bugs. */
+    getQueuedTasks(cwd: string): QueuedTask[];
     /** Update the messagePreview for a queued task. Returns true if found and updated. */
-    updateQueuedTaskMessage(workspace: string, messageId: string, newMessage: string): boolean;
+    updateQueuedTaskMessage(cwd: string, messageId: string, newMessage: string): boolean;
     /**
      * Build the orange queue card reflecting the edited message content. Returns
      * the card object (sent as the cardAction callback response `card.data`,
@@ -235,9 +242,9 @@ export declare class QueueManager {
      * concurrent PATCH updateCard result. Returning { card } in the callback
      * response updates the card synchronously with no API race.
      */
-    buildQueueCardForEdit(workspace: string, messageId: string, newMessagePreview: string): object | null;
+    buildQueueCardForEdit(cwd: string, messageId: string, newMessagePreview: string): object | null;
     /**
-     * Decrement `pendingOrExecutingCount` for a workspace, honoring per-slot
+     * Decrement `pendingOrExecutingCount` for a cwd, honoring per-slot
      * interrupt bookkeeping.
      *
      * Called from the queue chain's `.then()`/`.catch()` settle with the slot
@@ -253,7 +260,7 @@ export declare class QueueManager {
      */
     private decrementExecutingCount;
     /**
-     * Reset the executing task count for a workspace.
+     * Reset the executing task count for a cwd.
      *
      * This should be called when a running task is interrupted externally
      * (e.g., via /stop command or "立即执行" button) so that the queue
@@ -278,10 +285,10 @@ export declare class QueueManager {
      * running successor and mark ITS slot interrupted, hiding it from the
      * queue card (A22).
      */
-    resetExecutingCount(workspace: string, expectedSlot: number): void;
+    resetExecutingCount(cwd: string, expectedSlot: number): void;
     /**
-     * The slot id of the task currently executing in this workspace (if any).
+     * The slot id of the task currently executing in this cwd (if any).
      */
-    getExecutingSlot(workspace: string): number | undefined;
+    getExecutingSlot(cwd: string): number | undefined;
 }
 export {};