@co0ontty/wand 4.83.1 → 4.84.0

package/dist/structured-session-manager.d.ts

@@ -1,12 +1,22 @@
+import { type OpenRouterFreeModelsService } from "./openrouter-free-models.js";
+import { type StructuredFailure } from "./structured-failure.js";
 import { type WorktreeSetupSpec } from "./git-worktree.js";
 import { SessionLogger } from "./session-logger.js";
 import { WandStorage } from "./storage.js";
 import { ConversationTurn, ExecutionMode, ProcessEvent, SessionProvider, SessionRunner, SessionSnapshot, SessionSource, WandConfig } from "./types.js";
 import type { WandTaskAgent } from "./task-types.js";
+import type { CoreStatus } from "./core-status-cli.js";
+import { type EngineResolution } from "./harness-engine.js";
+import { type PiSessionSettings } from "./pi-session-settings.js";
 import { type DecisionRuntimeAccess } from "./decision-runner.js";
 import { type StructuredExecHost } from "./structured-exec-host.js";
 import type { StructuredRunnerAdapter } from "./structured-runner.js";
 export interface StructuredSessionManagerRunners {
+    /**
+     * 宿主注入的执行器。注入 `pi` 视作钉死 CLI 引擎（`auto` 不覆盖）；
+     * 注入 `core` 则视为宿主提供了进程内 harness 能力。
+     */
+    core?: StructuredRunnerAdapter;
     claudeCli?: StructuredRunnerAdapter;
     codex?: StructuredRunnerAdapter;
     opencode?: StructuredRunnerAdapter;
@@ -16,6 +26,7 @@ export interface StructuredSessionManagerRunners {
     gemini?: StructuredRunnerAdapter;
 }
 interface CreateStructuredSessionOptions {
+    title?: string;
     cwd: string;
     mode: ExecutionMode;
     provider?: SessionProvider;
@@ -68,10 +79,18 @@ export declare class StructuredSessionManager {
     private readonly config;
     private readonly logger;
     private readonly execHost?;
+    private readonly decisionRuntime;
+    /** 「智能分配」专用的本地决策入口：只有真正能跑时才注入，没注入则用系统员工回退。 */
+    private readonly autoAssignEvaluate;
     private readonly sessions;
     private readonly pendingRunnerExecutions;
     private readonly unacceptedTeamStarts;
     private readonly interruptedWith;
+    /**
+     * 「智能分配」正在结算的会话：这段窗口内还没有 runner 归属，新输入必须排队而不是另起一轮。
+     * token.cancelled 由 stop / delete 置位，结算回来后不得再启动。
+     */
+    private readonly autoAssignPending;
     private readonly preserveQueueOnInterrupt;
     /** Last wall-clock time (ms) a streaming checkpoint reached SQLite. */
     private readonly lastStreamSaveAt;
@@ -88,6 +107,11 @@ export declare class StructuredSessionManager {
     private readonly relayHandlers;
     private emitEvent;
     private archiveTimer;
+    /**
+     * 静默期心跳：回合在飞且连续 TURN_QUIET_HEARTBEAT_MS 没有任何事件时，用现有的
+     * status 事件重发一次权威快照（含最新 turn 锚点）。timer 只在 inFlight 期间存在。
+     */
+    private readonly turnHeartbeat;
     private readonly topicCoordinator;
     private readonly nativeTitles;
     private readonly streamEmitTimers;
@@ -97,6 +121,12 @@ export declare class StructuredSessionManager {
     private readonly grokRunner;
     private readonly qoderRunner;
     private readonly piRunner;
+    /** 进程内 core 引擎供员工候选显式启用；普通 Pi 主功能不使用它。 */
+    private readonly coreRunner;
+    /** 宿主是否显式注入了 pi 的 CLI runner / core runner，供系统级引擎状态使用。 */
+    private readonly piRunnerSupplied;
+    private readonly coreRunnerSupplied;
+    private coreRestartDrains;
     private readonly geminiRunner;
     /** Structured CLI runs that were mid-flight when the previous web process died. */
     private pendingRecoveryIds;
@@ -104,9 +134,16 @@ export declare class StructuredSessionManager {
     private detachedRecoveryRetryTimer;
     private detachedRecoveryFailureLogged;
     private disposed;
-    constructor(storage: WandStorage, config: WandConfig, logger?: SessionLogger | null, runners?: StructuredSessionManagerRunners, execHost?: StructuredExecHost | undefined, decisionRuntime?: () => DecisionRuntimeAccess | null);
+    constructor(storage: WandStorage, config: WandConfig, logger?: SessionLogger | null, runners?: StructuredSessionManagerRunners, execHost?: StructuredExecHost | undefined, decisionRuntime?: () => DecisionRuntimeAccess | null, openRouter?: OpenRouterFreeModelsService, 
+    /** 「智能分配」专用的本地决策入口：只有真正能跑时才注入，没注入则用系统员工回退。 */
+    autoAssignEvaluate?: () => DecisionRuntimeAccess["evaluate"]);
     private archiveExpiredSessions;
     setEventEmitter(emitEvent: (event: ProcessEvent) => void): void;
+    getCoreTurnStatus(): CoreStatus;
+    /** Keep current turns running; new Pi inputs stay in the durable input queue. */
+    beginCoreRestartDrain(): () => void;
+    /** Resume accepted inputs after a cancelled drain or after a successful restart. */
+    resumeQueuedPiMessages(): void;
     /** Stop every runner and flush terminal state before storage is closed. */
     dispose(): void;
     /** Called once after startup wiring; transient daemon failures retry automatically. */
@@ -130,7 +167,7 @@ export declare class StructuredSessionManager {
     get(id: string): SessionSnapshot | null;
     setSessionWorkspace(id: string, membership: Pick<SessionSnapshot, "workspaceId" | "workspaceTaskId">): void;
     setSessionTopic(id: string, title: string, description: string): SessionSnapshot;
-    /** 归档 / 取消归档：只写标记并广播，不中断运行中的 run，也不删历史。 */
+    /** 归档会先停掉还在跑的回合，会话 ID 和 provider session id 都留着。 */
     setSessionArchived(id: string, archived: boolean): SessionSnapshot;
     private setSessionTopicGenerating;
     /**
@@ -150,10 +187,14 @@ export declare class StructuredSessionManager {
     }): SessionSnapshot;
     /** Server-only generation anchor, including a failed unaccepted turn whose activeRequestId is cleared. */
     teamRequestId(id: string): string | null;
-    /** Consume only the exact failed request observed by the team's dispatch, never error-text inference. */
+    /** Compatibility boolean API; typed consumers preserve the reason without parsing user-facing text. */
     consumeUnacceptedTeamStartup(id: string, requestId: string): boolean;
-    /** Only an unstarted employee conversation may change CLI after a failed first turn. */
+    /** Consume only the exact failed request observed by dispatch, once, before a newer request can replace it. */
+    consumeUnacceptedTeamFailure(id: string, requestId: string): StructuredFailure | null;
+    private employeeCandidateModel;
+    /** Only an unstarted employee conversation may replay its explicitly rejected first input. */
     private retryEmployeeCandidate;
+    private throwUnacceptedInput;
     /** 往转发会话里追加别的参与者的发言。 */
     appendRelayTurns(id: string, turns: ConversationTurn[]): SessionSnapshot | null;
     sendMessage(id: string, input: string, opts?: {
@@ -186,6 +227,12 @@ export declare class StructuredSessionManager {
     clearQueuedMessages(sessionId: string): SessionSnapshot;
     /** 新建空白对话可原位换 CLI；接受过输入、恢复会话和自动化不跨 provider 搬历史。 */
     setSessionProvider(sessionId: string, provider: SessionProvider): SessionSnapshot;
+    getPiSettings(sessionId: string): {
+        settings: PiSessionSettings;
+        resolution: EngineResolution;
+    };
+    /** Metadata-only, synchronous merge: active runs retain their captured settings, queued rounds see these. */
+    setPiSettings(sessionId: string, patch: unknown): SessionSnapshot;
     /** Update the selected model for a structured session. Takes effect on the next spawn. */
     setSessionModel(sessionId: string, model: string | null): SessionSnapshot;
     /**
@@ -216,7 +263,34 @@ export declare class StructuredSessionManager {
     private currentSessionForRequest;
     /** Delete a handle only if it still belongs to the execution doing cleanup. */
     private releasePendingRunnerExecution;
+    /**
+     * 本轮开始：turnStartedAt / lastActivityAt 同时落下，并给这一轮挂上静默心跳。
+     * 只在新回合（新 requestId）起点未知时调用；daemon 领养走 adoptTurn。
+     */
+    private beginTurn;
+    /**
+     * 领养 daemon 里仍在飞的回合：起点是重启前那一轮的真实时刻，不能改写成重连时刻；
+     * 锚点缺失（改动之前落库的历史数据）才退回现在。
+     */
+    private adoptTurn;
+    /**
+     * 观测到本轮活动（输出 chunk / 状态变化）：只刷新 lastActivityAt 并重新计算静默窗口；
+     * turnStartedAt 保持不变，客户端才算是「这一轮已经跑了多久」而不是「距离上一条输出多久」。
+     */
+    private noteTurnActivity;
+    /**
+     * 本轮收敛：`inFlight` 清 false 的一切路径（结束 / 失败 / 停止 / 中断 / 重启降级 /
+     * 候选降级）都必须走这里——两个锚点一起回 null，静默心跳立即 cancel。
+     * 收敛后不存在任何「还在跑」的读数，客户端不需要再猜上一轮的锚点属于哪一轮。
+     */
+    private settleTurn;
+    /**
+     * 静默窗口到期：确认这一轮仍在飞才补发一次，payload 与一条普通 status 快照完全一致
+     * （不带新字段、不开新事件类型）。返回值决定要不要再挂下一个窗口。
+     */
+    private publishQuietHeartbeat;
     private emitStructuredSnapshot;
+    private enqueueInput;
     private flushNextQueuedMessage;
     private emit;
     private incrementApprovalStats;