newmark-agent 0.6.3 → 0.6.7

package/dist/core/conversationKernel.d.ts

@@ -1,4 +1,4 @@
-import { Agent, AutoRouteRatingResult } from './agent';
+import { Agent } from './agent';
 import { AgentMode, AgentWorkEvent, ConversationInputEnvelope, ConversationImageAttachment, GuideReceipt, OptionQuestion } from './types';
 import { AutomationManager } from './automation';
 import { ConversationRuntimeTarget, NormalizedConversationTarget } from './conversationTarget';
@@ -19,8 +19,12 @@ export interface ConversationQueueItemSnapshot {
     /** Exact workspace ledger branch id used when this row was admitted. */
     ledgerBranchId?: string;
     modelSelection?: string;
+    /** Ledger reason shown when a queued row cannot run (for example DEPENDENCY_FAILED). */
+    waitingReason?: string;
+    /** True when the ledger currently blocks this row from being claimed. */
+    blocked?: boolean;
 }
-export type ConversationQueueAction = 'enqueue' | 'update' | 'delete' | 'reorder' | 'toggle_pause' | 'set_pause' | 'guide';
+export type ConversationQueueAction = 'enqueue' | 'update' | 'delete' | 'reorder' | 'toggle_pause' | 'set_pause' | 'repair_blocked' | 'guide';
 export interface ConversationQueueActionInput {
     id?: string;
     text?: string;
@@ -87,8 +91,7 @@ export interface AgentPromptMessage {
         attachments?: ConversationImageAttachment[];
     }>;
     routePolicy?: {
-        mode?: 'quality' | 'balanced' | 'cost' | 'speed';
-        maxQualityLoss?: number;
+        mode?: 'conservative' | 'balanced' | 'aggressive';
         maxExpectedCostUsd?: number;
         allowPreview?: boolean;
         privacy?: 'default' | 'no_training' | 'zdr';
@@ -156,7 +159,6 @@ export interface ConversationKernelRunResult {
     workRuns: Agent['workRuns'];
     routeDecision?: Agent['lastRouteDecision'];
     resolvedDeployment?: ReturnType<Agent['activeDeployment']>;
-    autoRouteRatingAvailable?: boolean;
 }
 export type ConversationTargetInput = string | ConversationRuntimeTarget;
 export interface ConversationRuntimeState {
@@ -216,6 +218,32 @@ export declare class ConversationKernel {
     private listeners;
     private readonly eventLimit;
     private generations;
+    /**
+     * Durable continuation ledgers are read on every queue projection and state
+     * snapshot. Building a fresh store each time re-parsed (and previously also
+     * re-wrote) the whole JSON ledger, so a long conversation became slower with
+     * every turn. The store revalidates its cache through the ledger file
+     * fingerprint on each read, so one instance per branch stays authoritative.
+     */
+    private readonly continuationStores;
+    /** Throttles orphan sweeps per branch so snapshots stay read-only and cheap. */
+    private readonly orphanSweepAt;
+    /**
+     * dev-0.6.6: is the process that owns an attempt still alive?
+     *
+     * Attempts record their owner as `kernel:<pid>`. A dead owner can never write
+     * a terminal state, so its build/guard must be reclaimed by a live reader
+     * instead of waiting for a claim that nobody will ever make.
+     */
+    private workerCapabilityAlive;
+    /**
+     * Reclaim an orphaned queued turn (dead owner / long-expired lease) and, when
+     * the conversation is idle and its queue is not paused, let the queue run
+     * again. Field evidence: a utility host died of V8 OOM mid-turn and left the
+     * build RUNNING with an expired guard, so every later queued row entered the
+     * panel but never executed.
+     */
+    private maybeRecoverOrphanedAttempt;
     constructor(root: string, host: Agent, automation: AutomationManager | null, lifecycle?: ConversationKernelLifecycle);
     subscribe(listener: WorkListener): () => void;
     isRunning(target: ConversationTargetInput): boolean;
@@ -252,7 +280,27 @@ export declare class ConversationKernel {
     }): string | null;
     settleExternalRun(target: ConversationTargetInput, completed: boolean): void;
     releaseExternalRun(target: ConversationTargetInput, paused: boolean): void;
-    prepareForArchive(target: ConversationTargetInput): Promise<Agent | null>;
+    /**
+     * Start an archive for one conversation.
+     *
+     * An archive has to wait for the conversation's own run to settle before the
+     * writer takes its payload snapshot and deletes the state entry: a run that
+     * is still writing would otherwise append to a conversation that no longer
+     * exists (silently losing the tail), and its trailing state flush would
+     * resurrect the archived entry. That wait is not a budget to be truncated —
+     * it is real work, and the way to end it is to *release the occupancy* the
+     * run is holding, not to give up on it.
+     *
+     * So the caller passes the hard stop of the resident runtime as
+     * `releaseOccupancy`. It runs concurrently with the settle below: the hard
+     * stop invalidates the in-flight request (the client rejects every pending
+     * request of the evicted generation), which is exactly what makes a wedged
+     * run finish. Both teardown paths therefore overlap instead of serializing,
+     * and no timer exists to mask a runtime that refuses to end.
+     */
+    prepareForArchive(target: ConversationTargetInput, options?: {
+        releaseOccupancy?: () => Promise<void> | void;
+    }): Promise<Agent | null>;
     finishArchive(target: ConversationTargetInput, completed: boolean, preserveOwner?: boolean): void;
     isAnyRunning(): boolean;
     hasRetainedWork(): boolean;
@@ -303,6 +351,14 @@ export declare class ConversationKernel {
     deleteQueueItem(target: ConversationTargetInput, idInput: string): boolean;
     reorderQueueItems(target: ConversationTargetInput, orderedIdsInput: string[]): ConversationQueueItemSnapshot[];
     setQueuePaused(target: ConversationTargetInput, paused: boolean): boolean;
+    /**
+     * dev-0.6.4 hotfix: 显式修复被失败前置阻断的排队行。
+     *
+     * 0.6.3 的合约是「失败/取消阻断后继，且不静默跳过」，所以这里不挂在恢复动作上
+     * 自动执行；它必须由用户的显式动作触发（界面上的“修复受阻队列”按钮）。每一次
+     * 改挂都写入 `BuildQueueRepaired` 事件并发布可见状态，触发者与原因可审计。
+     */
+    private repairBlockedQueueNow;
     queueAction(target: ConversationTargetInput, action: ConversationQueueAction, input?: ConversationQueueActionInput): {
         ok: boolean;
         queueItems: ConversationQueueItemSnapshot[];
@@ -345,7 +401,6 @@ export declare class ConversationKernel {
         conversationLocked: false;
         routeDecision: Agent['lastRouteDecision'];
         resolvedDeployment: ReturnType<Agent['activeDeployment']>;
-        autoRouteRatingAvailable: boolean;
     };
     runtimeStates(): ConversationRuntimeState[];
     enqueueGuide(envelope: ConversationInputEnvelope): GuideReceipt;
@@ -357,7 +412,6 @@ export declare class ConversationKernel {
         at: string;
     };
     compressContext(target: ConversationTargetInput, options?: ConversationContextCompressOptions): Promise<Record<string, unknown>>;
-    rateAutoRoute(target: ConversationTargetInput, score: number, expectedRouteId?: string): AutoRouteRatingResult;
     setWorkRunExpanded(target: ConversationTargetInput, runId: string, expanded: boolean): boolean;
     setInputMode(target: ConversationTargetInput, mode: string): 'guide' | 'next';
     setMode(target: ConversationTargetInput, mode: AgentMode): AgentMode;