qlogicagent 2.24.7 → 2.24.9

package/dist/types/contracts/turn-event.d.ts

@@ -45,6 +45,10 @@ export type TurnEvent = {
     type: "end";
     turnId: string;
     content: string;
+    /** Adapter lifecycle only; it is not a semantic task-success claim. */
+    turnStatus?: "completed" | "stopped";
+    /** Task success remains unverified unless a higher-level product workflow proves it. */
+    taskOutcome?: "unverified";
     usage?: WireTokenUsage;
     model?: string;
     provider?: string;
@@ -104,17 +108,6 @@ export type TurnEvent = {
     keepLength: number;
     /** 供 UI 呈现"已重试/已重新生成"的轻量状态,以及诊断归因。 */
     reason: string;
-} | {
-    type: "tool_selection_policy";
-    turnId: string;
-    policyId: string;
-    intent: "benchmark_state_maintenance" | "fresh_evidence" | "verification" | "final_answer" | "tool_recovery" | "lifecycle_reconciliation";
-    reason: string;
-    availableToolNames: string[];
-    enabledToolNamesBefore: string[];
-    enabledToolNamesAfter: string[];
-    suppressedToolNames: string[];
-    nextAction: string;
 } | {
     type: "plan_update";
     turnId: string;
@@ -128,10 +121,9 @@ export type TurnEvent = {
     type: "tool_use_summary";
     turnId: string;
     telemetrySource?: "agent";
-    /** Versioned terminal ledger for per-call execution and final-answer evidence. */
-    ledgerSchemaVersion: 4;
+    /** Versioned terminal ledger for per-call execution evidence. */
+    ledgerSchemaVersion: 5;
     toolCalls: import("./tool-execution-evidence.js").ToolCallExecutionEvidence[];
-    finalAnswerEvidence: import("./tool-execution-evidence.js").FinalAnswerEvidence;
     availableToolNames: string[];
     enabledToolNames: string[];
     toolCallNames: string[];
@@ -139,30 +131,13 @@ export type TurnEvent = {
         name: string;
         reason: string;
     }>;
-    argumentCorrections?: {
-        roleAlias: number;
-        promptAlias: number;
-        backgroundAlias: number;
-        agentValue: number;
-        backgroundValue: number;
-    };
 } | {
     type: "lifecycle";
     turnId: string;
-    kind: "stage" | "reopen" | "resume" | "context_compression" | "goal_reconstruction" | "memory_drift" | "artifact_path_drift";
+    kind: "stage" | "reopen" | "resume" | "context_compression";
     stage?: string;
     status?: string;
     detail?: string;
-    reconstruction?: GoalReconstructionState;
-    observedAt?: string;
-} | {
-    type: "document_maintenance";
-    turnId: string;
-    checkpointId: string;
-    documents: MaintainedDocumentIndex[];
-    decisionStateTable: DecisionStateRecord[];
-    readCycleFindings: Array<Record<string, unknown>>;
-    readCycleGuard: ReadCycleGuard;
     observedAt?: string;
 } | {
     type: "reasoning_delta";
@@ -202,20 +177,6 @@ export type TurnEvent = {
     language?: string;
     content?: string;
     mimeType?: string;
-} | {
-    type: "artifact_contract";
-    turnId: string;
-    artifactRoot?: string;
-    writePaths: string[];
-    outOfRootWrites: Array<{
-        path: string;
-        artifactRoot: string;
-        toolName: string;
-    }>;
-    devServerUrls: string[];
-    browserVerified: boolean;
-    browserEvidence: string[];
-    requiresBrowserAcceptance: boolean;
 } | {
     type: "annotations";
     turnId: string;
@@ -240,38 +201,3 @@ export type TurnEvent = {
     outputPreview?: string;
     error?: string;
 };
-export interface GoalReconstructionState {
-    goal: string;
-    artifactRoot: string;
-    decisions: string[];
-    defects: string[];
-    acceptanceCriteria: string[];
-    blockers: string[];
-    nextAction: string;
-}
-export interface MaintainedDocumentIndex {
-    name?: string;
-    path?: string;
-    indexed: true;
-    maintained: true;
-    indexVersion: string;
-    contentHash: string;
-    summary: string;
-    lastReviewedTurn: number;
-    fileSizeBytes: number;
-    recordCount: number;
-}
-export interface DecisionStateRecord {
-    id: string;
-    decision: string;
-    status: string;
-    evidence: string;
-    lastConfirmedTurn: number;
-}
-export interface ReadCycleGuard {
-    strategy: string;
-    nextReadPolicy: string;
-    budgetStatus: "within-budget";
-    maxReadsPerDocument: number;
-    observedReadsByPath: Record<string, number>;
-}

package/dist/types/orchestration/tool-loop/tool-choice-policy.d.ts

@@ -34,7 +34,6 @@ export interface ApplyToolChoicePolicyInput<TTool extends ToolChoiceToolLike> {
 export interface ApplyToolChoicePolicyResult<TTool extends ToolChoiceToolLike> {
     tools: TTool[];
     normalizedToolChoice?: ToolChoiceLike;
-    extraSystemPrompt?: string;
     warnings: string[];
 }
 export declare function filterEligibleTools<TTool extends ToolChoiceToolLike>(params: {

package/dist/types/protocol/wire/notification-payloads.d.ts

@@ -20,6 +20,8 @@ export interface TurnTextRollbackNotification {
 export interface TurnEndNotification {
     turnId: string;
     content: string;
+    turnStatus?: "completed" | "stopped";
+    taskOutcome?: "unverified";
     usage?: WireTokenUsage;
     model?: string;
     provider?: string;

package/dist/types/runtime/config/tunable-defaults.d.ts

@@ -15,21 +15,8 @@
  */
 /** Default temperature for LLM calls (0 = deterministic). */
 export declare const DEFAULT_TEMPERATURE = 0;
-/** Hard cap on tool calls per round (prevents runaway). */
-export declare const MAX_TOOL_BUDGET_CAP = 100;
-/** Default tool budget per round. Overridable via TOOL_LOOP_DEFAULT_BUDGET env. */
-export declare const DEFAULT_TOOL_BUDGET: number;
 /** Foreground tool execution deadline in ms. Long jobs should use background tasks. */
 export declare const DEFAULT_TOOL_EXECUTION_TIMEOUT_MS: number;
-/** Max consecutive tool call failures before early exit. */
-export declare const MAX_CONSECUTIVE_FAILURES = 3;
-/** Max times the exact same (tool_name, arguments) pair can repeat. */
-export declare const MAX_IDENTICAL_CALL_REPEATS = 2;
-/** Max hard failures for the same normalized target before blocking.
- *  Generic typed tools use their full canonical arguments, so a corrected schema or payload is a
- *  different invocation. Search and exec retain their domain-specific normalized target keys.
- *  Soft-empty results and rejected proposals are not executions and do not consume this budget. */
-export declare const MAX_TOOL_VARIANT_FAILURES = 2;
 /** Default context window size (tokens). */
 export declare const DEFAULT_CONTEXT_WINDOW_TOKENS = 128000;
 /** Reserved tokens for model response output. */
@@ -42,10 +29,6 @@ export declare const DEFAULT_MODEL_MAX_OUTPUT_TOKENS = 65536;
 export declare const MAX_OUTPUT_TOKENS_RECOVERY_LIMIT = 3;
 /** Escalated max output tokens during recovery (CC: 64k). */
 export declare const ESCALATED_MAX_OUTPUT_TOKENS = 65536;
-/** Delta threshold for "diminishing returns" detection (CC: 500). */
-export declare const DIMINISHING_RETURNS_THRESHOLD = 500;
-/** Min consecutive continuations before diminishing returns kicks in. */
-export declare const DIMINISHING_RETURNS_MIN_CONTINUATIONS = 3;
 /** Per-tool result size threshold (chars) for disk persistence. */
 export declare const DEFAULT_MAX_RESULT_SIZE_CHARS = 50000;
 /** Per-message aggregate tool result budget (chars). */
@@ -113,19 +96,13 @@ export declare const TASK_PANEL_GRACE_MS = 30000;
  */
 export interface TunableDefaults {
     defaultTemperature: number;
-    maxToolBudgetCap: number;
-    defaultToolBudget: number;
     defaultToolExecutionTimeoutMs: number;
-    maxConsecutiveFailures: number;
-    maxIdenticalCallRepeats: number;
     defaultContextWindowTokens: number;
     responseBufferTokens: number;
     defaultMaxOutputTokens: number;
     defaultModelMaxOutputTokens: number;
     maxOutputTokensRecoveryLimit: number;
     escalatedMaxOutputTokens: number;
-    diminishingReturnsThreshold: number;
-    diminishingReturnsMinContinuations: number;
     defaultMaxResultSizeChars: number;
     maxToolResultsPerMessageChars: number;
     toolResultPreviewBytes: number;

package/dist/types/runtime/infra/agent-project-projection.d.ts

@@ -17,4 +17,3 @@ export type AgentProjectSnapshot = {
 export declare function materializeAgentProjectProjection(projectId: string, workspaceDir: string): void;
 export declare function readAgentProjectProjection(): AgentProjectSnapshot;
 export declare function resetAgentProjectProjection(): void;
-export declare function setAgentProjectProjectionForTests(next: AgentProjectSnapshot): void;

package/dist/types/runtime/infra/subagent-turn-snapshot.d.ts

@@ -76,4 +76,3 @@ export declare function recordSubagentActivity(payload: SubagentActivitySnapshot
 export declare function recordSubagentCompleted(payload: SubagentCompletedSnapshotInput): PersistedSubagentSnapshot;
 export declare function recordSubagentDecision(payload: SubagentDecisionSnapshotInput): PersistedSubagentSnapshot | undefined;
 export declare function subagentActivityBlock(snapshot: PersistedSubagentSnapshot): Record<string, unknown>;
-export declare function clearSubagentTurnSnapshotsForTests(): void;

package/dist/types/runtime/ports/agent-runtime-ports.d.ts

@@ -73,7 +73,6 @@ export interface ToolLoopRuntimePorts {
         budget: number;
         model: string;
     }): RuntimeCompressionResult;
-    getBudgetContinuationMessage(usagePct: number, totalUsed: number, tokenBudget: number): string;
     createStreamingToolExecutor(config: StreamingToolExecutorPortConfig): StreamingToolExecutorPort;
     resolveToolEligibility(tools: ToolDefinition[], context: unknown): {
         eligibleTools: ToolDefinition[];

package/dist/types/runtime/prompt/system-prompt-sections.d.ts

@@ -3,7 +3,6 @@
  *
  * Provides a section-based system prompt assembly mechanism:
  *   - Memoized sections (computed once, cached until clear)
- *   - Volatile sections (recompute every turn, cache-breaking)
  *   - User-provided appendSystemPrompt / customSystemPrompt
  *   - Clear on session reset / compact
  *
@@ -13,25 +12,15 @@ type ComputeFn = () => string | null | Promise<string | null>;
 export interface SystemPromptSection {
     name: string;
     compute: ComputeFn;
-    /** If true, recompute every turn (breaks prompt cache). CC: cacheBreak. */
-    cacheBreak: boolean;
 }
 /**
  * Create a memoized system prompt section.
  * Computed once, cached until clearSystemPromptSections() is called.
  */
 export declare function systemPromptSection(name: string, compute: ComputeFn): SystemPromptSection;
-/**
- * Create a volatile system prompt section that recomputes every turn.
- * WARNING: This WILL break prompt cache when the value changes.
- * Use sparingly — only for time-sensitive or frequently changing context.
- *
- * @param _reason - Why this section must be volatile (documentation only, CC parity).
- */
-export declare function volatileSystemPromptSection(name: string, compute: ComputeFn, _reason?: string): SystemPromptSection;
 /**
  * Resolve all system prompt sections, returning non-null prompt strings.
- * Memoized sections are cached; volatile sections are always recomputed.
+ * Memoized sections are cached until the section cache is cleared.
  */
 export declare function resolveSystemPromptSections(sections: SystemPromptSection[]): Promise<string[]>;
 /**
@@ -39,8 +28,6 @@ export declare function resolveSystemPromptSections(sections: SystemPromptSectio
  */
 export declare function clearSystemPromptSections(): void;
 export interface SystemPromptAssemblyOptions {
-    /** Include internal prompt-policy metadata for diagnostics. Defaults to false. */
-    includePromptPolicy?: boolean;
     /** Base system prompt (from Gateway config) */
     basePrompt?: string;
     /** Prepended instruction block (from INSTRUCTIONS.md files) */

package/dist/types/skills/tools/agent-tool.d.ts

@@ -47,11 +47,6 @@ export interface AgentResult {
     error?: string;
     maxTurnsReached?: boolean;
     tokensUsed?: number;
-    uiAcceptanceEvidence?: Array<{
-        source: "fork_verify";
-        status: "passed";
-        summary: string;
-    }>;
 }
 /**
  * Host-provided fork execution backend.

package/dist/types/skills/tools/write-tool.d.ts

@@ -21,28 +21,20 @@ export declare const WRITE_TOOL_SCHEMA: {
 };
 /** Deps injected by the host runtime for file writing. */
 export interface WriteToolDeps {
-    /** Write content to a file. Create parent dirs as needed. */
+    /** Create a text file. Create parent dirs as needed. */
     writeFile(path: string, content: string, options?: TextFileWriteOptions): Promise<void>;
     /** Check whether the resolved path already exists. */
     fileExists?(path: string): Promise<boolean> | boolean;
     /** Resolve a relative path to absolute. */
     resolvePath(input: string): string;
-    /**
-     * Check if file has been read before writing (first-read-then-write protection).
-     * Returns null if write is allowed, or a warning message.
-     * If not provided, no protection is applied.
-     */
+    /** Legacy host hook; create-only writes never need an existing-file read. */
     checkReadBeforeWrite?(path: string): string | null;
     /**
      * Validate write access for the given path.
      * Returns null if allowed, or an error message if blocked.
      */
     validatePath?(path: string): string | null;
-    /**
-     * Check for concurrent modification before overwriting an existing file.
-     * Returns null if safe to write, or a warning if modified since last read.
-     * If not provided, no concurrent modification check is performed.
-     */
+    /** Legacy host hook; retained in the injected port until its consumers migrate. */
     checkConcurrentModification?(path: string): string | null;
 }
 export declare function createWriteTool(deps: WriteToolDeps): PortableTool<WriteToolParams>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "qlogicagent",
-  "version": "2.24.7",
+	"version": "2.24.9",
   "packageManager": "pnpm@10.23.0",
   "description": "XiaozhiClaw standard ACP Agent adapter",
   "type": "module",
@@ -53,7 +53,6 @@
     "test": "vitest run",
     "test:slow": "vitest run --config vitest.release.config.ts",
     "test:release": "pnpm test && pnpm run test:slow",
-    "test:replay": "vitest run benchmarks/transcript-replay",
     "benchmark:multi-session-real": "tsx benchmarks/multi-session-real/runner.ts",
     "check": "node scripts/run-check.mjs",
     "test:watch": "vitest",
@@ -78,8 +77,8 @@
   "dependencies": {
     "@agentclientprotocol/sdk": "^0.25.0",
     "@napi-rs/canvas": "0.1.100",
-    "@xiaozhiclaw/module-sdk": "0.4.4",
-    "@xiaozhiclaw/provider-core": "0.1.40",
+    "@xiaozhiclaw/module-sdk": "0.4.5",
+		"@xiaozhiclaw/provider-core": "0.1.41",
     "ajv": "8.20.0",
     "better-sqlite3": "^12.10.0",
     "dotenv": "^17.3.1",

package/dist/types/agent/tool-loop/agent-argument-normalizer.d.ts

@@ -1,12 +0,0 @@
-export interface HostToolArgumentNormalization {
-    rawArguments: string;
-    corrections: string[];
-}
-/**
- * Repairs a small, explicit set of common weak-model aliases at the host boundary.
- *
- * The public tool schema remains narrow. Unknown role values are copied into the
- * canonical `agent` field so the normal tool validation rejects them instead of
- * silently falling back to a generalist.
- */
-export declare function normalizeHostToolArguments(toolName: string, rawArguments: string): HostToolArgumentNormalization;

package/dist/types/agent/tool-loop/artifact-final-contract.d.ts

@@ -1,171 +0,0 @@
-import type { ChatMessage } from "../types.js";
-export interface ArtifactContractState {
-    artifactRoot?: string;
-    rootSource?: "explicit" | "inferred";
-    writePaths: string[];
-    deletedPaths: string[];
-    outOfRootWrites: Array<{
-        path: string;
-        artifactRoot: string;
-        toolName: string;
-    }>;
-    devServerUrls: string[];
-    browserVerified: boolean;
-    browserEvidence: string[];
-    browserFailureEvidence: string[];
-    /** Build/test verification: a test/build/compile command ran and passed (exit 0). */
-    buildVerified: boolean;
-    buildEvidence: string[];
-    buildFailureEvidence: string[];
-    /**
-     * Ledger sizes recovered from prior turns' history at turn start. The recovered ledger keeps
-     * cross-turn claims reconcilable (a model may legitimately cite files written last turn), but
-     * it is NOT this turn's evidence — the engine fallback block only fires on new entries.
-     */
-    recoveredBaseline?: {
-        writePaths: number;
-        devServerUrls: number;
-        artifactRoot: boolean;
-    };
-}
-export type UiAcceptanceEvidenceSource = "browser_automation" | "frontend_test" | "user_confirmation" | "external_benchmark" | "fork_verify";
-export interface UiAcceptanceEvidence {
-    source: UiAcceptanceEvidenceSource;
-    status: "passed" | "failed";
-    summary: string;
-}
-export interface ArtifactContractEventPayload {
-    artifactRoot?: string;
-    writePaths: string[];
-    deletedPaths: string[];
-    outOfRootWrites: Array<{
-        path: string;
-        artifactRoot: string;
-        toolName: string;
-    }>;
-    devServerUrls: string[];
-    browserVerified: boolean;
-    browserEvidence: string[];
-    browserFailureEvidence: string[];
-    requiresBrowserAcceptance: boolean;
-}
-export interface TaskContractItem {
-    id: number;
-    title: string;
-    status: string;
-}
-export declare function createArtifactContractState(inputMessages: readonly ChatMessage[]): ArtifactContractState;
-export declare function requiresBrowserAcceptance(inputMessages: readonly ChatMessage[]): boolean;
-export declare function requiresBuildVerification(inputMessages: readonly ChatMessage[]): boolean;
-export type FinalStatusBrowserVerdict = "verified" | "failed" | "not-run";
-export type FinalStatusBuildVerdict = "passed" | "failed" | "not-run";
-export interface FinalStatusClaim {
-    schema: number;
-    author?: "model" | "engine";
-    done?: string[];
-    notDone?: string[];
-    artifacts?: {
-        root?: string;
-        files?: string[];
-        urls?: string[];
-    };
-    verification?: {
-        browser?: FinalStatusBrowserVerdict;
-        build?: FinalStatusBuildVerdict;
-    };
-    sources?: {
-        cited?: string[];
-    };
-    blockers?: string[];
-    nextAction?: string;
-}
-export interface ParsedFinalStatusBlock {
-    /** null = a block was present but not valid schema-1 JSON (malformed). */
-    claim: FinalStatusClaim | null;
-    start: number;
-    end: number;
-}
-/** The final-status contract applies only to turns whose tool surface can produce artifacts or run verification. */
-export declare function finalStatusContractApplies(toolNames: Iterable<string>): boolean;
-export declare const FINAL_STATUS_PROMPT_CONTRACT: string;
-/** Locate and parse the last ```final-status block. Returns null when no block exists. */
-export declare function parseFinalStatusBlock(content: string): ParsedFinalStatusBlock | null;
-export declare function renderFinalStatusBlock(claim: FinalStatusClaim): string;
-export declare function toolCallWritePath(toolName: string, rawArguments: string): string | null;
-export declare function resolveArtifactRootWriteBlock(params: {
-    state: ArtifactContractState;
-    inputMessages: readonly ChatMessage[];
-    toolName: string;
-    rawArguments: string;
-}): {
-    path: string;
-    artifactRoot: string;
-    error: string;
-} | null;
-export declare function resolveReadOnlyContextPackWriteBlock(params: {
-    toolName: string;
-    rawArguments: string;
-}): {
-    path: string;
-    error: string;
-} | null;
-export declare function recordArtifactRootBlock(state: ArtifactContractState, params: {
-    path: string;
-    artifactRoot: string;
-    toolName: string;
-}): void;
-export declare function updateArtifactContractFromToolResult(params: {
-    state: ArtifactContractState;
-    inputMessages: readonly ChatMessage[];
-    toolName: string;
-    rawArguments: string;
-    ok: boolean;
-    content: string;
-    details?: Record<string, unknown>;
-}): void;
-export declare function recordUiAcceptanceEvidence(state: ArtifactContractState, evidence: UiAcceptanceEvidence): void;
-export declare function artifactContractPayload(state: ArtifactContractState, inputMessages: readonly ChatMessage[]): ArtifactContractEventPayload;
-export declare function recoverArtifactContractState(inputMessages: readonly ChatMessage[]): ArtifactContractState;
-export declare function updateArtifactContractFromFinalContent(state: ArtifactContractState, content: string): void;
-export interface FinalStatusReconciliation {
-    content: string;
-    /** A ```final-status block was present but not valid schema-1 JSON (treated as absent). */
-    malformedBlock: boolean;
-    /** Internal claim corrections for telemetry/logging. Never append these to assistant prose. */
-    notices: string[];
-}
-/**
- * Locale for engine-authored final-status content. Only the fixed wording skeleton is localized;
- * dynamic data (paths, tool names, counts, blocker reasons, evidence) is always verbatim.
- * Model-authored claims are untouched — they already follow the conversation language.
- */
-export type EngineStatusLocale = "zh" | "en";
-/**
- * Derive the conversation locale from the LAST user message's text. Han characters → "zh",
- * otherwise "en" (including when no string-content user message exists). Only the newest user
- * turn matters, so engine status follows the language the user is currently writing in.
- */
-export declare function deriveConversationLocale(messages: readonly ChatMessage[]): EngineStatusLocale;
-export declare function reconcileFinalStatus(params: {
-    content: string;
-    /** From finalStatusContractApplies() over the turn's tool surface; inactive turns pass through untouched. */
-    contractActive: boolean;
-    totalToolCallCount: number;
-    distinctToolNames: Iterable<string>;
-    visibleToolCallCount?: number;
-    visibleToolNames?: Iterable<string>;
-    artifactContract: ArtifactContractState;
-    blockedToolCalls?: ReadonlyArray<{
-        name: string;
-        reason: string;
-    }>;
-    activeTasks?: readonly TaskContractItem[];
-    /** The turn ended on a forced/failure terminal rather than a clean model stop. */
-    forcedStop?: boolean;
-    /**
-     * Conversation language for engine-authored content. Defaults to "en" so existing tests and
-     * non-Chinese sessions are unaffected. Model-authored claims ignore this — they already follow
-     * the conversation language.
-     */
-    locale?: EngineStatusLocale;
-}): FinalStatusReconciliation;

package/dist/types/agent/tool-loop/budget-continuation-policy.d.ts

@@ -1,26 +0,0 @@
-import type { AgentLogger, ThinkingBlock, TokenUsage, ToolLoopTransition } from "../types.js";
-export interface BudgetContinuationPolicyInput {
-    tokenBudget: number | undefined;
-    totalUsage: TokenUsage;
-    budgetContinuationCount: number;
-    lastBudgetDeltaTokens: number;
-    lastBudgetGlobalTokens: number;
-    messages: unknown[];
-    finalText: string;
-    thinkingBlocks: readonly ThinkingBlock[];
-    getBudgetContinuationMessage(usagePct: number, totalUsed: number, tokenBudget?: number): string;
-    log: Pick<AgentLogger, "info">;
-    /** The loop's per-turn recovery trace (surfaced on the final `end` event). Stop
-     * reasons are recorded here as `budget_continuation_stop:<reason>` so an engine-side
-     * end of nudging is visible to callers/UI, not only in the debug log. */
-    recoveryTrace?: Map<string, number>;
-}
-export interface BudgetContinuationPolicyDecision {
-    messages: unknown[];
-    budgetContinuationCount: number;
-    lastBudgetDeltaTokens: number;
-    lastBudgetGlobalTokens: number;
-    recoveryDetail: string;
-    transition: ToolLoopTransition;
-}
-export declare function resolveBudgetContinuationPolicy(input: BudgetContinuationPolicyInput): BudgetContinuationPolicyDecision | null;

package/dist/types/agent/tool-loop/completion-action-policy.d.ts

@@ -1,48 +0,0 @@
-import type { AgentLogger, ChatMessage, ThinkingBlock, ToolLoopTransition } from "../types.js";
-export type CompletionActionPolicyReason = "file_action_verification" | "explicit_required_file_verification" | "explicit_extra_file_verification" | "artifact_index_evidence_verification" | "multi_file_skeleton_verification" | "forbidden_file_creation" | "self_created_read_target";
-export interface CompletionActionPolicyInput {
-    inputMessages: readonly ChatMessage[];
-    messages: unknown[];
-    finalText: string;
-    thinkingBlocks: readonly ThinkingBlock[];
-    stopHookActive: boolean | undefined;
-    totalToolCallCount: number;
-    distinctToolNames: ReadonlySet<string>;
-    log: Pick<AgentLogger, "info">;
-}
-export interface CompletionActionPolicyDecision {
-    reason: CompletionActionPolicyReason;
-    messages: unknown[];
-    stopHookActive: true;
-    transition: ToolLoopTransition;
-}
-export declare function findMissingExplicitRequiredFiles(inputMessages: readonly ChatMessage[], messages: unknown[]): string[];
-/**
- * Terminal-path NOTE (not a replacement): when a forced stop ends the turn with
- * explicitly-requested output files still missing, this returns an engine-attributed
- * note to APPEND to whatever the turn is already ending with. It used to return a
- * "<FAIL-marker> ..." string that REPLACED the model's final text — an extraction
- * misfire then handed the user an engine-authored FAIL verdict the model never made
- * (2026-07-07 review, F5). The engine reports evidence; it does not speak as the model.
- */
-export declare function buildMissingRequiredFilesNote(input: {
-    inputMessages: readonly ChatMessage[];
-    messages: unknown[];
-    reason: string;
-}): string | undefined;
-type CandidateToolCall = {
-    id: string;
-    function: {
-        name: string;
-        arguments: string;
-    };
-};
-export declare function buildPrematureCompletionArtifactBlock(input: {
-    inputMessages: readonly ChatMessage[];
-    messages: unknown[];
-    toolCall: CandidateToolCall;
-}): string | undefined;
-export declare function findForbiddenCreatedFiles(inputMessages: readonly ChatMessage[], messages: unknown[]): string[];
-export declare function findSelfCreatedReadTargets(inputMessages: readonly ChatMessage[], messages: unknown[]): string[];
-export declare function resolveCompletionActionPolicy(input: CompletionActionPolicyInput): CompletionActionPolicyDecision | null;
-export {};

package/dist/types/agent/tool-loop/completion-stop-policy.d.ts

@@ -1,19 +0,0 @@
-import type { AgentLogger, HookRegistry, ThinkingBlock, ToolLoopTransition } from "../types.js";
-export type CompletionStopPolicyDecision = {
-    action: "end";
-    content: string;
-} | {
-    action: "continue";
-    messages: unknown[];
-    stopHookActive: true;
-    transition: ToolLoopTransition;
-};
-export interface CompletionStopPolicyInput {
-    hooks: HookRegistry | undefined;
-    sessionId: string;
-    messages: unknown[];
-    finalText: string;
-    thinkingBlocks: readonly ThinkingBlock[];
-    log: Pick<AgentLogger, "info">;
-}
-export declare function resolveCompletionStopPolicy(input: CompletionStopPolicyInput): Promise<CompletionStopPolicyDecision | null>;

package/dist/types/agent/tool-loop/direct-response-contract.d.ts

@@ -1,12 +0,0 @@
-/** True when a no-tool answer leaked provider tool-protocol syntax as visible prose. */
-export declare function containsToolProtocolMarkup(text: string): boolean;
-export interface DirectResponseProtocolStreamFilter {
-    push(chunk: string): string;
-    flush(): string;
-}
-/**
- * Hold only the ambiguous beginning of a direct response. Provider protocol leaks start with
- * an opening marker; keeping that short prefix out of the UI prevents a transient tool-call
- * trace while preserving normal token streaming as soon as the prefix is proven ordinary text.
- */
-export declare function createDirectResponseProtocolStreamFilter(): DirectResponseProtocolStreamFilter;

package/dist/types/agent/tool-loop/final-status-stream-suppressor.d.ts

@@ -1,22 +0,0 @@
-/**
- * 流式输出中的 final-status 围栏抑制。
- *
- * 为什么必须在**解析层**抑制而不是"先显示再回滚":final-status 是引擎内部协议块
- * (```final-status + JSON),`reconcileFinalStatus` 会在回合末重写它。若照原样流给用户,
- * 用户会看着一段裸 JSON 被逐字打出来,然后被终局文本替换。产品决定是内部协议文本
- * **任何时候都不允许短暂展示**,所以它必须在进入 delta 流之前就被拦掉,回滚机制不适用于它。
- *
- * 关键约束:标记可能跨 chunk 边界到达("```final-" + "status\n"),因此不能逐 chunk 独立判断。
- * 未确定安全之前必须扣住可能构成标记前缀的尾巴。
- *
- * 本模块只过滤**发给消费端的流**;完整原文仍照常进入 roundText/finalText,终局内容不受影响。
- */
-export interface FinalStatusStreamSuppressor {
-    /** 吃进一段原文,返回此刻可安全外发的文本(可能为空)。 */
-    push(chunk: string): string;
-    /** 流结束:返回残留的安全文本。仍处于未闭合的抑制区时返回空串。 */
-    flush(): string;
-    /** 是否正处于 final-status 块内部(诊断用)。 */
-    isSuppressing(): boolean;
-}
-export declare function createFinalStatusStreamSuppressor(): FinalStatusStreamSuppressor;