newmark-agent 0.5.11 → 0.5.13

package/dist/core/agent.d.ts

@@ -331,6 +331,13 @@ export declare class Agent {
     private branchMailbox;
     private nextBranchMessageSequence;
     private branchCommunicationEnabled;
+    /**
+     * Title/model availability is a hard gate for the first formal response.
+     * These values mirror the current conversation's persisted gate state so a
+     * failed first attempt cannot be bypassed by a second ordinary user send.
+     */
+    private titleRequestMessageId;
+    private firstAgentResponseStarted;
     private compressionArchiveCountCache;
     private nextCompressionCacheId;
     private readonly compressionHistoryArchive;
@@ -512,6 +519,12 @@ export declare class Agent {
     private conversationEntryForDisk;
     private normalizeWorkRuns;
     private recoverPersistedWorkRuns;
+    /** Close tool calls left without results by a hard worker exit. */
+    private repairDanglingToolCalls;
+    repairDanglingToolCallsForTest(messages: Array<Record<string, unknown>>): {
+        messages: Array<Record<string, unknown>>;
+        changed: boolean;
+    };
     private pauseFlowAfterUnexpectedExit;
     beginConversationWorkRun(runId: string, target?: ConversationTarget, startedAt?: string, managed?: boolean, runtimeKey?: string): ConversationWorkRun;
     private buildHistoryStatus;
@@ -678,16 +691,16 @@ export declare class Agent {
         title: string;
     };
     /**
-     * 首 Build 命名判定：仅当 (1) 当前对话尚无历史 Build（排除当前 run）且
-     * (2) 其持久化 title 仍是自动生成（含为空）时返回 true。dev-0.4.3 起不再
-     * 用该判定注入首轮 tool-call 指令，而是在首个完成 Build 的最终响应处自动
-     * 命名（见 maybeAutoRenameConversationFromRun）。判定本身只读存储、无副作用。
+     * Compatibility query for callers that still expose the rename affordance.
+     * Automatic naming itself is a hard pre-response gate: until the persisted
+     * firstAgentResponseStarted flag is true, every ordinary send must finish a
+     * title probe for the first persisted user message before formal execution.
      */
     shouldPromptConversationRename(): boolean;
     /**
-     * 从首个 Build 的最终响应中提取一个简短对话标题。跳过 Markdown 标题/列表
-     * 符号与固定 section 标题，取第一条有意义的摘要句并做保守清洗。
-     * dev-0.4.5 起仅作为独立 rename API 不可用时的本地回退。
+     * Legacy explicit-rename sanitizer retained for compatibility tests only.
+     * Automatic naming must never use an Agent/Build summary as a fallback;
+     * the independent first-input title probe is the sole automatic source.
      */
     private deriveConversationTitleFromSummary;
     /**
@@ -696,19 +709,27 @@ export declare class Agent {
      */
     private normalizeConversationRenameTitle;
     /**
-     * 用独立的 provider API 请求为对话生成标题（与主响应并行、不共享主前缀缓存）。
-     * system 约束模型只按格式返回一个简短名词短语标题；失败、超时或无 provider 时
-     * 返回空字符串，由调用方回退到本地 deriveConversationTitleFromSummary。
+     * Run the independent, tool-free title/model-availability probe. It shares
+     * the frozen deployment selected for this send, but no main Agent history or
+     * tool schema. An empty result keeps the formal response hard-blocked.
      */
     private deriveConversationTitleFromProvider;
+    /** Legacy completion hook retained as a no-op; naming is pre-response only. */
+    private maybeAutoRenameConversationFromRun;
+    private startFirstInputConversationTitle;
+    private firstPersistedUserForTitleGate;
     /**
-     * dev-0.4.5：conversation_rename 流程独立为「并行响应 API」。首个完成 Build 的
-     * 最终响应到达时，fire-and-forget 发起一个独立 provider 请求生成标题并按格式
-     * rename，不阻塞主流程、不污染主前缀缓存；无 provider / 失败时回退本地启发式。
-     * conversation_rename 工具与 shouldPromptConversationRename 判定均保留，且不再
-     * 在首轮 prompt 注入一次性 tool-call 指令。
+     * Conversations saved before the durable title gate existed have no explicit
+     * flag. Prior assistant history or any persisted WorkRun proves that their
+     * first formal response already started. An explicit false is authoritative:
+     * it represents a failed title probe that must remain blocked across reloads.
      */
-    private maybeAutoRenameConversationFromRun;
+    private restoredFirstAgentResponseStarted;
+    getConversationTitleGateState(): {
+        titleRequestMessageId: string;
+        firstAgentResponseStarted: boolean;
+    };
+    private markFirstAgentResponseStarted;
     reorderConversations(ids: string[]): boolean;
     /** Reorder one pinned group inside an explicit workspace without changing membership. */
     reorderWorkspaceConversationGroup(ids: string[], ws: WorkspaceInfo | null): boolean;
@@ -731,7 +752,7 @@ export declare class Agent {
     persistActiveConversationSelection(id: string, ws?: WorkspaceInfo | null): string;
     setInputMode(mode: string): InputMode;
     private defaultInputMode;
-    abortActiveKernelRun(): boolean;
+    abortActiveKernelRun(reason?: string): boolean;
     activeProcessSignal(): AbortSignal | undefined;
     recordWorkRunPrimaryPrompt(content: string): void;
     conversationBuildHistory(limit?: number): Array<{
@@ -826,11 +847,15 @@ export declare class Agent {
     handleContextHistoryManage(args: string): NewmarkToolResult;
     recordContextCompressionStep(): void;
     compressionContinuationPrompt(): string;
-    mirrorConversationStateFrom(id: string, source: Pick<Agent, 'chatMessages' | 'history' | 'conversationPlan'> & Partial<Pick<Agent, 'linkedPlan' | 'subagents' | 'workRuns' | 'continuations'>> & {
+    mirrorConversationStateFrom(id: string, source: Pick<Agent, 'chatMessages' | 'history' | 'conversationPlan'> & Partial<Pick<Agent, 'linkedPlan' | 'subagents' | 'workRuns' | 'continuations' | 'getConversationTitleGateState'>> & {
         modelSelection?: ConversationModelSelection;
         inputMode?: InputMode;
         mode?: AgentMode;
         goal?: StoredGoalState | null;
+        titleGateState?: {
+            titleRequestMessageId?: string;
+            firstAgentResponseStarted?: boolean;
+        };
     }): void;
     getConversationPlan(conversationId?: string): ConversationPlanState;
     updateConversationPlan(plan: Partial<ConversationPlanState>, conversationId?: string): ConversationPlanState;